Ask HN: Best way for a Markdown based blog and eBook?
35 points by apineda 1 year ago | 23 comments- paeselhz 1 year 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/
- 2cynykyl 1 year agoQuarto FTW! I uses pandoc to translate between formats, is almost effortless to use, and seems to be growing very fast.
- 2cynykyl 1 year ago
- asicsp 1 year agoI use pandoc to convert markdown to pdf+epub (https://learnbyexample.github.io/customizing-pandoc/). For web version, I use 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/) or Mau (https://project-mau.github.io/index.html)
- nick238 1 year 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 1 year agoAnd AsciiDoc seems roughly equivalent to rST.
- euroderf 1 year ago
- hoofhearted 1 year 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!
- abdullahkhalids 1 year 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.
- i_don_t_know 1 year agoIf it’s a technical book, you might like 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.
- lioeters 1 year 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
I learned about it because it's used for The Nature of Code 2nd Edition.
- fuzztester 1 year 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 1 year ago[flagged]
- fuzztester 1 year ago
- fuzztester 1 year ago
- avikalp 1 year 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.
- brycelarkin 1 year agoI just used a Vercel template. Literally took 10 minutes from cloning the repo to getting it set up on my domain.
- sixhobbits 1 year 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).
- scriptstar 1 year agoI used 11ty (eleventy) for my static site blog. (Data Is A Dope)[https://DataIsAdope.com]
- JoeAltmaier 1 year agoScrivener is an editor that can compile a book to multiple formats.
- cut3 1 year 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.
- AstroJetson 1 year 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.
- billconan 1 year agoI use pandoc for the ebook generation. for the website, I tend to write my own generator.
- stillpoint 1 year agomkdocs-material
- mtsolitary 1 year agoHugo works very nicely.
- hiAndrewQuinn 1 year 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 1 year 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.
- octo-andrero 1 year ago
- hiAndrewQuinn 1 year ago
- 1 year ago
- brudgers 1 year agoA typewriter?
I mean writing is the most important part of writing a book.
Good luck.