remarkable

Turn a Markdown or Org document into a PDF that looks like a classic CS paper and reads well on e-ink: the MIT AI memo look, sized for the reMarkable. New Computer Modern Book, 10pt article, small-caps section headings, monochrome code, URLs as footnotes. Pandoc reads both formats; the examples below say DOC.md, and an Org source only changes the two spots called out in steps 4 and 5.

The source document is never modified. All transformation happens in a print copy under the session scratchpad.

1. Check the toolchain

which pandoc tectonic

Both required. If either is missing, ask the user to install it (brew install pandoc tectonic); do not install it for them.

2. Survey non-ASCII characters

Latin Modern Mono lacks box-drawing and arrow glyphs; they render as blanks. Find what the document uses:

LC_ALL=C grep -o '[^ -~]' DOC.md | LC_ALL=C sort | LC_ALL=C uniq -c | LC_ALL=C sort -rn

LC_ALL=C on every stage is load-bearing: macOS locale collation silently merges distinct Unicode punctuation, and the survey lies without it.

Curly quotes, en/em dashes, and ellipses are fine (Latin Modern has them). Arrows and box-drawing characters must be transliterated in the print copy.

3. Make the print copy

Write to the scratchpad, never next to the source:

sed -E -e 's/──>/-->/g' -e 's/└─>/\\->/g' -e 's/→/->/g' \
       -e 's/─/-/g' -e 's/└/\\/g' -e 's/│/|/g' -e 's/├/+/g' \
       DOC.md > "$SCRATCH/DOC-print.md"

Extend the substitution list for whatever the survey found. Order matters: replace multi-character sequences (──>, └─>) before their parts.

4. Decide the numbering

Check whether headings already carry their own numbers (## 3. The publish API). Double numbering looks broken ("14.1 1. Publish one normal post").

• Headings are unnumbered prose: pass --number-sections.
• Headings self-number at every level: drop --number-sections.
• Mixed (numbered subsections under prose sections): keep --number-sections and strip the manual numbers in the print copy, e.g. add -e 's/^### [0-9]+\. /### /' to the sed above (for Org sources the heading marker is stars: -e 's/^\*\* [0-9]+\. /** /'). Only do this when the generated numbers still line up with any cross-references to the old ones.