Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

MdBook – a command line tool to create books with Markdown

rust-lang.github.io

Post reply on HN
Print view View original

11–20 of 71 posts

Re: MdBook – a command line tool to create books with Markdown

#11

Post by ognarb »

cyberax wrote: post #4

While we're on the topic of MD, what's the best system for Markdown-based static blogs these days? With good code highlighting, images, colors, etc.

I love hugo, it's a bit complex to get started with but extremely powerful. And the backward compatibility is very good, I started using that 4 years ago and aside of a handful of small issues which could be resolved in 5 min, my websites could be upgraded without any issue. This wasn't my experience with Jekyll.

Re: MdBook – a command line tool to create books with Markdown

#14

Post by thangalin »

cyberax wrote: post #4

While we're on the topic of MD, what's the best system for Markdown-based static blogs these days? With good code highlighting, images, colors, etc.

> best system for Markdown-based static blogs

I use my Markdown editor[1] to produce my blog[2].

      keenwrite.bin -q -i "${FILE_MD}" -o "${FILE_HTML}" \
        --curl-quotes=true
Offers external variable sources, too; see [3] and [4].

[1]: https://keenwrite.com/

[2]: https://dave.autonoma.ca/blog/

[3]: https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/docs/cmd...

[4]: https://www.youtube.com/watch?v=CFCqe3A5dFg

Re: MdBook – a command line tool to create books with Markdown

#16

Post by yndoendo »

Moved from MD to LaTeX for documentation. Content maybe shared between two or more documents. Was copying and pasting to fix multiple locations for simple spelling errors. Now there is a single LaTex file to edit for all complete documents.

Issue is that the file system layout is more like this:

/Product A/images/

/Product A/revision.tex

/Product A/instalwin7.tex

/Product A/instalwin10.tex

/Product A/layout.tex

/Product B/layout.tex

/Commmon/images/

/Common/companyinfo.tex

/Common/header.tex

/Win7/images

/Win7/access-cmd.tex

/Win10/images

/Win10/access-cmd.tex

Where Product A and Product B layout.tex links all LaTex files needed to build a complete document.

Re: MdBook – a command line tool to create books with Markdown

#18

Post by nemosaltat »

j_bum wrote: post #9
nemosaltat wrote: post #7

Earlier quoted context omitted.

I’ve been running quarto [0] for a few months now and I’m happy with it. Posts are saved as .qmd, with a little bit of special front matter for formatting and tagging. `quarto render` converts the .qmd(s) according to a simple config file. [0] https://quarto.org/

+1 for quarto. I love it for my personal website, and I use it on a daily basis to create technical reports for my day job.

Do you have any details on your workflow for reports? I “think” in .mds and the. use a VScode extension that creates to PDF on .md save with a custom/header footer template- works 95% of the time but it’s more brittle than I’d like.

Re: MdBook – a command line tool to create books with Markdown

#19

Post by jessyco »

cyberax wrote: post #4

While we're on the topic of MD, what's the best system for Markdown-based static blogs these days? With good code highlighting, images, colors, etc.

I've enjoyed building with SveltKit reading markdown files and processing them with it, into a static hosted site.

Re: MdBook – a command line tool to create books with Markdown

#20

Post by reagle »

nemosaltat wrote: post #7
cyberax wrote: post #4

While we're on the topic of MD, what's the best system for Markdown-based static blogs these days? With good code highlighting, images, colors, etc.

I’ve been running quarto [0] for a few months now and I’m happy with it. Posts are saved as .qmd, with a little bit of special front matter for formatting and tagging. `quarto render` converts the .qmd(s) according to a simple config file. [0] https://quarto.org/

I’ve been waiting for them to release a standalone markdown editor, but it’s been a couple years already now.
Post reply on HN