Files
khosra/examples/demo-site/content/writing/notes-on-water/index.en.md
T
Claude Opus 5andbdeshi 53e9ef473a add inline notation, and take the tilde back from strikethrough
~sub~, ^sup^, ==mark==, and ~~strike~~ moved in from goldmark. Not a
preference: goldmark's strikethrough claims a single tilde as well as a double,
so with it enabled H~2~O rendered as H<del>2</del>O — measured before the
change. Two features cannot share a byte and both be correct, so notation owns
it and the authored syntax stays exactly as ADR-0058 documented.

The second failure was worse and only showed up under test. Under delimiter
rules `x^2 + y^2 = z^2` pairs its carets across the whole expression and renders
x<sup>2 + y</sup>2 — prose silently becoming markup, in exactly the content this
engine is for. So a single run is scanned rather than paired, and may not cross
whitespace: a subscript holds a formula, never a phrase. Pandoc draws the same
line. The cost is that a single run takes its content literally, so there is no
emphasis inside a subscript, which the ADR states rather than leaving to be
discovered.

New package under internal/ext, which is a stop condition and was asked. It
takes the extensions counter to 4, past its threshold, and the answer is still
no: four features attach in three unrelated ways, and two goldmark extenders
compose in goldmark's own extender list, which is already the registry for that
shape.

The example site's hand-copied extender list drifted, exactly as the latent row
added last loop predicted — the demo case failed and named it. Both are now in
step again.

core 2794/2800, ext 1236/2000, 34 gates green, 0 warnings.
2026-08-01 21:21:04 +06:00

1.2 KiB

title, date, tags
title date tags
Notes on Water 2026-03-25
monsoon
journal

The finished piece. Below, a part of it lives in a separate file and is included here:

::include{file=_method.md}

That fragment starts with an underscore, so the scanner never treats it as a bundle: it has no URL of its own and appears in no listing. An included file cannot itself include — one level, deliberately.

This bundle also has an extras/ directory, so the theme offers a link to it at the foot of the page.

The dialect

The page has a footnote of its own1 , a table, a definition list and a struck phrase.

The notation marks cover what prose needs most often: the gauge measures H2O to about 10^-3^ m, and the ==important== column is the second. Where there is no mark for something, HTML does it: the reading is taken with Shift held. Content in the site root is the author's own, so it renders rather than being dropped.

Gauge Reading Note
North 41 mm steady
South 12 mm falling
Monsoon
The season these readings belong to.
Gauge
A calibrated vessel, read by eye.

  1. Numbered from one, independently of the fragment's. ↩︎