Show HN: Markdown-to-Book – Convert Markdown to KDP Ready PDFs and EPUBs(github.com)
github.com
Show HN: Markdown-to-Book – Convert Markdown to KDP Ready PDFs and EPUBs
https://github.com/vpuna/markdown-to-book
6 comments
[deleted]
I am an engineer too, and have written a hard science fiction Novel: https://www.amazon.com/dp/B0GFTDY4ZL
Given that there are so few of us writing hard sci-fi, I would like to read your novelette. Where is it available?
Given that there are so few of us writing hard sci-fi, I would like to read your novelette. Where is it available?
Hey, thanks! mine is at https://www.amazon.com/dp/B0GQ8B1SN7
The Kindle book is free right now.
Enjoyed it very much! Self contained though it is, it would make an excellent opening part to a First Contact story. I've left a review on Amazon. I can offer other comments directly to you, but I'll leave that up to you.
Thank you for the review comments!
This is a good application !
Something I made on markdown : https://voiden.md
Something I made on markdown : https://voiden.md
The workflow: I write stories in .md files, one heading per chapter, --- for scene breaks. When I'm ready to publish, I run one command and get a paperback PDF, hardcover PDF, and Kindle EPUB with correct margins, typography, and scene breaks. The tool wraps Pandoc and XeLaTeX with a custom LaTeX template and a Lua filter that handles the scene break conversion. Commander.js is the only Node dependency.
I used this to publish my first novelette, a hard sci-fi story called "The Pull" about an astrophysicist mapping the Zone of Avoidance behind the Milky Way. The science in the story is grounded in real astrophysics (the Great Attractor, large scale cosmic flows, the Zone of Avoidance). I also built an author website at 'alanvoss.me' with Next.js and Payload CMS, deployed as a static site on Vercel, where you can read the first chapter and see the characters.
On AI use and Graphics: The story concept and science are mine. I used Claude Opus 4.6 to help with some character dialogue and for grammar and spelling checks. Character portraits on the website were generated with Midjourney and OpenAI image models. Book covers were made in Canva.
The tool itself is simple (~200 lines of JS), but it solved a real problem for me. The KDP margin requirements are fiddly, especially the difference between paperback and hardcover inner margins, and getting scene breaks to render correctly in both LaTeX and EPUB needed the Lua filter approach. Hopefully useful to other developers who write.
Please let me know if you have any questions about the tool, the publishing process, or KDP in general.