exercises VS pandoc

# Ubuntu/Debian sudo apt-get install pandoc # macOS brew install pandoc # Windows choco install pandoc # Or download from https://pandoc.org/installing.html

I'd suggest downloading the Markdown from the repository and converting it to a PDF with Pandoc. You may also need to use pdftk, if you convert one file at a time and need to assemble those files into one PDF.

https://pandoc.org/

https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/

#!/bin/bash # integrate_go_docs.sh if [ "$#" -ne 2 ]; then echo "Usage: $0 " exit 1 fi if ! command -v pandoc &> /dev/null then echo "Error: pandoc is not installed. Please install pandoc to continue." exit 1 fi md_dir=$1 pages_dir=$2 tasks_dir="components/operator/tasks" nav_file="$pages_dir/../partials/task-operator-nav.adoc" echo "// This file has been generated on $(date)" > "$nav_file" # Convert task docs for md_file in "$md_dir"/*.md do adoc_dir="$pages_dir/$tasks_dir" adoc_file=$(basename "${md_file%.md}.adoc") adoc_path="$adoc_dir/$adoc_file" echo "Integrating $md_file" # -s to create a standalone document, including the title (=) # --shift-heading-level-by -1 to convert the markdown h1 (#) to asciidoc title (=) # See https://github.com/jgm/pandoc/issues/5615 # # --wrap=none to avoid wrapping lines, causing long headlines to be broken # See https://github.com/jgm/pandoc/issues/3277#issuecomment-264706794 pandoc -s -f markdown --shift-heading-level-by "-1" --wrap=none -t asciidoc -o "$adoc_path" "$md_file" echo "* xref:$tasks_dir/$adoc_file[]" >> "$nav_file" done

pandoc

Have only lightly dabbled in latex but Typst was super easy to pickup. I recently even published a whole book[0] in Typst. The process was straightforward for the most part. It took a little time to work out how to get page numbers alternating between the left and right side and a few other small formatting details but by and large it was very easy to create a beautiful PDF that's ready for printing.

Also, pandoc has fairly good support for Typst so I use that to create a docx (which Draft2Digital converts to epub). I even opened a few issues (https://github.com/jgm/pandoc/issues?q=sort%3Aupdated-desc%2...) for pandoc support and they were almost all resolved pretty quickly.

[0]: https://thelabofthought.co/shop/p/nbmi3

I've used Typst to produce books (for https://printstack.net) and it's been excellent.

I started with this: https://news.ycombinator.com/item?id=42271078

But wouldn't recommend going via Pandoc, for example for this reason: https://github.com/jgm/pandoc/discussions/10438

pandoc: Convert tool, we can use it to covert HTML content to markdown

I get that people don't like the braces in TeX but ... :-)

I'm only half sarcastic here, I don't like them either. I have recently been using pandoc[1] to do the things they are talking about, I had added some stuff in perl using the Template Toolkit[2] to make HTML pages. My issue is that I have very different fugue states for writing vs. coding. Switching states breaks my flow so I've been trying to make the two modes as orthogonal as possible.

I'm curious if anyone has used something like this to go straight to PNG. My use case is that I have a surplus epaper display that can display pngs it fetches from the network and I've been forwarding it my todo list. Have been doing this with a LuaTeX flow but would like something a bit more seamless.

[1] Pandoc -- https://pandoc.org/

[2] Template Toolkit -- https://template-toolkit.org/

wkhtmltopdf is not chromium though? "Wk" literally stands for WebKit.

There's also https://weasyprint.org/ which doesn't use any browser engine, but rather a custom renderer.

And both of those (and Prince) can be used as a backend by Pandoc (https://pandoc.org/)