3 ms·
For my recent book [1] I tried to first stick to Markdown with Pandoc. But Markdown is very limiting for books. Things like callouts, chapters and etc—are hard
by skwee357 3y ago
For my recent book [1] I tried to first stick to Markdown with Pandoc. But Markdown is very limiting for books. Things like callouts, chapters and etc—are hard to do in Markdown.
Therefor I switched to AsciiDoc with AsciiDoctor and I found it to be great. It has support for both ePub and PDF, custom themes, fonts and etc. The syntax is similar to Markdown, so I can use similar tools (Neovim) for writing.
I liked it, and would do it again.
[1] https://www.yieldcode.blog/book/technical-writing-for-software-engineers/ https://www.yieldcode.blog/book/technical-writing-for-softwa...