34 ms·
I've written a ~300 page book in MD using book-template [1], and I must say, it was a wonderful experience. I did 1 chapter = 1 file. It had tables, images, etc
by atomicnature 4y ago
I've written a ~300 page book in MD using book-template [1], and I must say, it was a wonderful experience. I did 1 chapter = 1 file. It had tables, images, etc with a nice TOC along with references and appendix. All the basics for writing a book work just fine with md, I'd say. Here is the output (in pdf, epub, html) for you to judge [2]
[1] https://github.com/alessandrocucci/book-template https://github.com/alessandrocucci/book-template
[2] https://turnoverbook.com/ https://turnoverbook.com/
- invalidname 4y agoHow did you do code callouts? Admonitions etc.? From my experience you need to use custom syntax for those which means tooling doesn't work well. (grammar, spelling, style etc.). O'Reilly and Manning standardized on asciidoc.
- atomicnature 4y agoFor extending markdown capabilities, there are many plugins/filters. Example [1]. I remember using extensions/filters for citations, etc. Ultimately it is just some custom tooling around pandoc; so whatever you can do in pandoc, you can get done in the book. [1] - https://github.com/chdemko/pandoc-latex-admonition https://github.com/chdemko/pandoc-latex-admonition [2] - https://pandoc.org/ https://pandoc.org/