C_W

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.

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 on t.
  • Diagrams and screens. Mermaid is drawn in the grid’s colours, and a screen block 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?