A notes site that looks like my terminal
A notes site drawn as a terminal draws Markdown, because that is the screen I look at all day, and because agents read the same file.
- Topic
- Experiments
- Reading
- 2 min
Most of my day is a terminal. Coding agents run in panes beside each other, every one of them a text interface, all in one mono font. So when I gave my notes their own address, cwdx.md, I made it look like that screen instead of like a blog.
The address is half the joke. cwdx is my handle on GitHub, and .md, Moldova’s country code, is also the extension every Markdown file ends in. A notes site written in Markdown could hardly ask for a better name.
It is an experiment, with two ideas behind it. Markdown is the point: what you read there is the file, coloured, not a page made from it. And agents read the same file people do.
The screen it copies
This is roughly what I look at, redrawn with made-up agents: the sessions on the left, the one I’m talking to in the middle, a live panel on the right.
┌────────────┬──────────────────────────┬─────────────┐ │ agents │ notes ─ claude │ status │ │ ● lead │ │ build ✓ │ │ done │ ● Shipped. Both sites │ tests ✓ │ │ ● site │ are live. │ deploy … │ │ working │ │ │ │ ● docs │ ❯ write the next note │ 18:25 │ │ working │ │ ▁▂▄▆▅▃▂▁ │ │ ○ inbox │ ⏵⏵ auto mode on │ │ └────────────┴──────────────────────────┴─────────────┘
Drawn the way glow draws it
glow is a tool that shows Markdown in a terminal. cwdx.md sets each note on a grid of character cells the way glow does, and a test holds its layout to glow’s own output at the same width. Headings keep their ##, code keeps its colours, and a table is drawn with box lines.
The page itself is a canvas, so it can do what a terminal can’t:
- A sea behind the text. A slow field of Markdown’s own marks moves around the column and ripples where you click.
- Real text underneath. Every word is laid over the drawing as invisible text, so it selects, copies, links and reads without JavaScript.
- Keys. Arrows move, enter opens, typing searches,
?shows the rest. Seven themes cycle ont. - Diagrams and screens. Mermaid is drawn in the grid’s colours, and a
screenblock like the one above shows a terminal as text, never an image.
Agents get the file
Ask for a note without a browser and cwdx.md answers with the Markdown, not HTML:
curl cwdx.md/a-notes-site-that-looks-like-my-terminal.md
The site also has an llms.txt, a sitemap and a feed, written from the same files. There is one source for people and machines, and nothing to keep in sync.
Open questions
- A canvas page is harder to make accessible than plain HTML. The text layer helps, but is it enough for a screen reader?
- Would a terminal-looking site still feel like home to someone who doesn’t live in one?