typscript is good
MdBook – a command line tool to create books with Markdown
21–30 of 71 posts
Re: MdBook – a command line tool to create books with Markdown
#22I am happily experimenting with Typst right now ( https://typst.app/ ), which compiles much faster than LaTeX and with a syntax very similar to md, together with nice support for math, figures and advanced settings.
Typst is amazing. You try it once and never want to go back to LaTeX again.
Re: MdBook – a command line tool to create books with Markdown
#23Earlier quoted context omitted.
+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.
So I render all of my reports to PDFs, and I work in RStudio (love/hate relationship).
As much as I love html outputs, it’s far easier to just email a pdf to my tech unsavvy stakeholders.
I’ll share my file header and config chunks with you tomorrow when I’m at the office! I’ll ping you with a separate reply.
Re: MdBook – a command line tool to create books with Markdown
#24I am happily experimenting with Typst right now ( https://typst.app/ ), which compiles much faster than LaTeX and with a syntax very similar to md, together with nice support for math, figures and advanced settings.
It's been talked about here a bunch of times: https://hn.algolia.com/?q=Typst
Re: MdBook – a command line tool to create books with Markdown
#25I am happily experimenting with Typst right now ( https://typst.app/ ), which compiles much faster than LaTeX and with a syntax very similar to md, together with nice support for math, figures and advanced settings.
Does anyone use Typst for multi-page documentation website? This is the most common use-case of mdbook.
Re: MdBook – a command line tool to create books with Markdown
#26Looks nice. I've used MkDocs in the past for https://baseball-stats.net.
Re: MdBook – a command line tool to create books with Markdown
#27If you have the mdbook-epub plugin, it's nice to be able to turn the myriad documentation "books" into actual ebooks that I can read on my kindle.
Re: MdBook – a command line tool to create books with Markdown
#28Has anyone here actually written technical books in LaTex and Markdown that can knowledgeably compare them? How do they compare? I’m biased from university towards LaTex but the MD syntax does seem way simpler.
Re: MdBook – a command line tool to create books with Markdown
#29Does anyone know a tool that would generate links automatically for types (etc) to Docs.rs. We have a library (Burn) and accompanying book where were references types in many places.
Re: MdBook – a command line tool to create books with Markdown
#30While 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.
Opinions—Hugo or Jekyll for blogs. Yes, that Jekyll! Hugo gives you more rope to shoot yourself in the foot with.
MkDocs or Docusaurus for documentation. MdBook is not in the running, IMO, unless it’s radically improved since the last time I checked.
And here’s my hot take—most generators have a lot of the same design flaws. Routing is generally a mistake—you should instead design a system where every page has a URL that directly corresponds to the source file path, if feasible. Shortcodes are a mistake—you should use custom HTML tags. SSGs should have e.g. S3+Cloudfront as a core part of their design rather than just thinking of S3 as a place you put files when you’re done.