Quiet Markdown Extras
The previous showcase covered standard Markdown — headings, lists, tables, the usual set. This post covers what’s layered on top of it. None of it changes how a post is written day to day; it’s there for the times it’s useful and invisible otherwise.
Wikilinks and note links
Writing [[On Intentional Software]] links straight to that post by title,
no need to look up its URL or nest it in a folder first: On Intentional
Software.
You can also use aliases with [[Target|Alias]], such as reflections on Kyoto,
or link directly to specific section anchors with [[Target#Heading]], such as
typographic craft.
Relative Markdown file links are also automatically converted at build time: see tools we shape. Every linked post automatically receives an inbound reference in its footer, keeping your publication’s web of thought connected.
Highlights and comments
Two bits of Obsidian-style inline syntax carry over. Wrapping text in double equals signs turns it into a highlight, useful for calling out the one sentence in a paragraph that matters most.
Wrapping something in double percent signs — like this: — removes it entirely from the rendered post. It exists in the source file, for the author’s own benefit, and nowhere else.
Callouts
Native Obsidian-compatible callouts render cleanly using blockquote syntax:
Subscript and superscript
Chemical formulas and footnote-style references read properly instead of looking like stray punctuation: water is H2O, and this is the 21st post-formatting feature covered in this pair of showcase posts.
Typography
Nothing to type for this one — it happens automatically. A paragraph written with plain ASCII quotes, a double-dash, and three dots – “like this one” – ends up with proper curly quotes, an en dash, and a real ellipsis instead of periods stacked in a row…
That’s the full list. All of it is optional syntax on top of ordinary Markdown — a post that never uses any of it reads exactly the same as one that does.