Skip to content

Quiet Markdown Extras

2 min read391 words

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.

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.