4 ms·
Ask HN: Best way for a Markdown based blog and eBook?
I'd like to write an ebook (epub, mobi) and web based book similar to what you see in many places. Anyone have a solid method, or tool recommendations to do this easily and look good? I'm thinking about using Astro for the web version.
- JoeAltmaier 2y agoScrivener is an editor that can compile a book to multiple formats.
- billconan 2y agoI use pandoc for the ebook generation. for the website, I tend to write my own generator.
- i_don_t_know 2y agoIf it’s a technical book, you might like https://jupyterbook.org/ https://jupyterbook.org/ I haven’t used it myself, so I don’t know how easy it is to use. But I like some books that were written in it.
- paeselhz 2y agoI've used Quarto[1] to build a personal blog and it has been really easy and straightforward. Especially if you want to run some code alongside the post (like Python, R, or Julia). As far as I know, you can also use it to write books and presentations. [1]: https://quarto.org/ https://quarto.org/
- 2cynykyl 2y agoQuarto FTW! I uses pandoc to translate between formats, is almost effortless to use, and seems to be growing very fast.
- brudgers 2y agoA typewriter? I mean writing is the most important part of writing a book. Good luck.
- hoofhearted 2y agoHey I’ve been working on a little hobby project for easily creating markdown based websites and blogs, using TipTap for the content editor and Git as the storage mechanism. I’d love to hear what you think! https://github.com/elegantframework/elegant-cli https://github.com/elegantframework/elegant-cli
- abdullahkhalids 2y agoMost static site generators will work to create a blog. I use pelican [1], which serves my needs. You will likely need to edit your blogposts a little bit before putting them in the book. So I recommend a separate program for that altogether. [1] https://getpelican.com/ https://getpelican.com/
- deleted 2y ago[deleted]
- nick238 2y agoIf you plan on needing much in the way of cross-references (i.e. like in documentation where you're linking to other things all the time), you can use a slightly more advanced markup language like rST (reStructuredText) which is used by Sphinx (though it also supports Markdown). Sphinx docs can be output to a variety of formats, including epub, single-file HTML, PDF via LaTeX, and of course, a multi-page HTML site.
- euroderf 2y agoAnd AsciiDoc seems roughly equivalent to rST.
- mtsolitary 2y agoHugo works very nicely.
- hiAndrewQuinn 2y agoI second Hugo. It's been my SSG of choice for a long time, and once you understand where to put things, it really lives up to its name. The fact that it's in Go, and therefore distributed as a single binary, also makes installation and use anywhere you want it a cakewalk. YMMV on how important that is to you, but I like to keep my tools light and nomadic when possible.
- octo-andrero 2y agoI use Hugo, GitHub to store blog and Cloudflare Pages to host it. This setup is free, straightforward and configures in few clicks. You only need to pay for the domain name.
- lioeters 2y agoI've been curious about "Magic Book" for Markdown/HTML/PDF. (EPUB and MOBI on the roadmap.) > The Magic Book Project is an open source project funded by New York University's Interactive Telecommunications Program. It aims to be the best free tool for creating print and digital books from a single source. https://github.com/magicbookproject/magicbook https://github.com/magicbookproject/magicbook I learned about it because it's used for The Nature of Code 2nd Edition. https://github.com/nature-of-code/noc-book-2 https://github.com/nature-of-code/noc-book-2
- fuzztester 2y agoSounded interesting, but this: >This project is for you, if: ... (last bullet point): >You want that command-line tool be be written in Node-only. No more XSLT. Put me off, personally.
- fuzztester 2y ago[flagged]
- stillpoint 2y agomkdocs-material https://squidfunk.github.io/mkdocs-material/ https://squidfunk.github.io/mkdocs-material/
- brycelarkin 2y agoI just used a Vercel template. Literally took 10 minutes from cloning the repo to getting it set up on my domain.
- sixhobbits 2y agoI have tried a bunch and would love a free OSS option but honestly Leanpub is the best I have found for ebook and printing. For web, I went Mkdocs material (cos I like Python) to Docusaurus (because it has more features) to Astro (because wow at speed and polish).
- AstroJetson 2y agoHuge fan of markdeep. It’s easy to use has a ton of functionality. It’s been here on HN a few times with lots of positive comments.
- cut3 2y agoI've been using a github repo for a book I wanted a digital version of and I love it. I really like github markdown is presented.
- asicsp 2y agoI use pandoc to convert markdown to pdf+epub (https://learnbyexample.github.io/customizing-pandoc/ https://learnbyexample.github.io/customizing-pandoc/). For web version, I use mdbook (https://github.com/rust-lang/mdBook https://github.com/rust-lang/mdBook) mainly because it comes with user choosable themes and search by default. However, if I had to start from scratch, I'd probably look at Quarto (https://quarto.org/ https://quarto.org/) or Mau (https://project-mau.github.io/index.html https://project-mau.github.io/index.html)
- scriptstar 2y agoI used 11ty (eleventy) for my static site blog. (Data Is A Dope)[https://DataIsAdope.com https://DataIsAdope.com]
- avikalp 2y agoWe have very recently integrated Strapi into our website (we haven't even added a single blog on it yet). I wish I had asked this question here when we were doing our research. There are some great recommendations here. But I like Strapi so far. Their documentation is pretty nice. Even if their onboarding is complicated, the documentation makes it easy to execute.