Hand written hypertext
Slowdown is a small syntax you add while writing by hand, so that Slownotes, or any tool, can turn your notes into something more.
Version 0.1 · Open specification · CC BY 4.0
Why Slowdown exists
Handwriting is slower and more thoughtful than typing. It is also harder to search, structure, and carry with you. The act of writing by hand has value that a keyboard cannot replace, but what we write on paper tends to stay on paper.
Existing syntaxes like Markdown and wiki syntax were built for a keyboard and a screen. Their symbols assume autocomplete, monospace fonts, and a cursor. None of that is available to a pen.
Slowdown is designed for the pen. A small set of symbols, chosen to survive messy handwriting and reliable OCR, and shaped for the natural movement of a hand across a page.
From page to structure
A handwritten page with Slowdown symbols becomes a structured document. People, tags, tasks, and discoveries are pulled out as their own metadata, and marked terms are expanded in place.
2026-04-24
# Bauhaus exhibition
Visited the Bauhaus* today.
Met @Anni in the weaving
workshop. #design #travel
□ Buy the catalogue
+ Colour as material
2026-04-24 · Journal
Bauhaus exhibition
Visited the Bauhaus (German art school, 1919 to 1933, unified craft and fine art) today.
Met @Anni in the weaving workshop.
#design #travel
Buy the catalogue
+ Colour as material
One pass reads the page, another structures the text, and a final pass fills in the marked terms with short definitions.
The syntax
Slowdown v0.1 defines five small groups of symbols. Each one is borrowed from a writing convention you already know, so there is nothing new to memorise.
Metadata and context
Who, what, when
- 2026-04-24
- DateA date at the top of the page sets the temporal context for everything on it.
- 2026-04-24
- # ## ###
- HeadingOne, two or three hashes followed by a space, for three levels of heading.
- # Kick-off
- @Name
- PersonAn at sign followed by a name. Multi-word names are supported, up to the next symbol or line break.
- Met @Anni today
- #tag
- TagA hash with no space, directly followed by a word. Letters, numbers, hyphens, underscores, and slashes are allowed.
- #design #travel
A hash with a space is a heading, a hash with no space is a tag. Same symbol, the space tells them apart.
Structure and segmentation
Breaks and blocks
- ───
- Section breakA horizontal line across the page marks a new section.
- ────────────
Actions and states
Things to do, and things done
- □
- To-doAn empty square at the start of a line is a task to complete.
- □ Send follow-up
- ■ ☑
- DoneA filled square or a checked box is a task completed. Either one works.
- ■ Proposal sent
Semantic enrichment
Notes for the reader, and the machine
- term*
- EnrichmentAn asterisk directly after a term asks the tool to add a short definition when the page is processed. Multi-word terms are supported.
- Bauhaus* was founded
in 1919. - + text
- DiscoveryA plus at the start of a line marks something worth surfacing later. Quotes, places, people, ideas, anything you want to find again.
- + Try the new coffee
shop on 5th Avenue
The asterisk trails the term. It is an instruction, not emphasis.
Hierarchy and emphasis
Signal what matters
- | text
- CalloutA vertical line down the left margin of a block sets it apart as important context or an aside.
- | Important context
| lives in this block - -> text
- Key pointAn arrow at the start of a line marks a decision or key insight.
- -> Launch confirmed
for Q2 - - text
- BulletA dash followed by a space starts a bullet list item.
- - First item
- Second item
Design principles
Five rules Slowdown must keep as it grows.
Conventional
Every symbol is borrowed from writing or note-taking conventions you already know.
Low cognitive load
No new glyphs. Only simple, easily written shapes that do not slow the hand.
Spatial and symbolic
Meaning is carried by symbols and by layout. The space on the page is part of the grammar.
Deterministic semantics
Each symbol has one primary meaning. No overloaded glyphs, no guessing games.
Human in the loop
You signal intent with the pen. The machine carries it out. No autonomous interpretation.
Licence and attribution
The Slowdown specification text is licensed under Creative Commons Attribution 4.0. You are free to share and adapt the specification, including for commercial use, as long as you credit Super Interactive.
Reference parsers and tooling published by Super Interactive are released under the MIT licence. The Slownotes app itself is a separate, proprietary product.
"Slowdown" and "Slownotes" are registered word marks of Super Interactive.
Versioning
- Current
- 0.1
- Stability
- Working specification. Syntax may evolve before 1.0.
- Changelog
- Coming soon