md-aio: read a whole folder of Markdown as one document
Contents
md-aio is a small local viewer for Markdown. Point it at a file or a folder and it opens a window that shows everything as one continuous document, laid out in newspaper-style columns about 80 characters wide. It was built for reading what AI agents write: long reports, plans and notes that change while you read them.
What it does#
- One document from many files. A folder's Markdown files are joined in order, each under its own file name.
- Columns, not scrolling. As many 80-character columns as fit the window; you page through them with the keyboard or the mouse wheel.
- Live reload. When a file changes on disk, the window updates in place and keeps your position.
- Math, tables and code. Formulas are rendered with KaTeX; tables and fenced code blocks look the way they should.
- Nothing from the internet. Every library and font is bundled, so a document can't make the viewer load remote code.
New this week#
Outline#
Press o for a sidebar listing the headings of every file. Click a heading to jump to it; the heading you are reading is marked.

Search across the folder#
Press / and type. Every match in every file is highlighted and counted; Enter, then n and N move between matches, Esc clears.

What changed#
When a file is rewritten while the window is open, the blocks that changed get a blue bar for a minute. Press c for a list of the last 20 changes, each under the heading it belongs to.

The renderer as a module#
The part that turns Markdown into HTML is now a module of its own, md-aio/render. A website can use it on the server to publish the same documents, with a stylesheet for phones and desktops, and the viewer uses the same module, so the two always agree.
How it is tested#
| Check | Result |
|---|---|
| Unit tests for the outline, search matching and change detection | 12 pass |
| Unit tests for the renderer: headings, tables, math, link rewriting, and input that tries to inject scripts | 10 pass |
| The real page in a headless browser: open a folder, open the outline, search, rewrite a file | All three features respond, no page errors |
| A long document with the outline open | Still two full columns, paging works |
The browser check is a script that drives a real Chrome over its debugging port, presses the keys, rewrites a file on disk and reads back what the page shows. The screenshots above come from that run.
Security#
md-aio listens only on the local machine. Each window carries a signed address, so one window can't be used to read another folder. Raw HTML inside Markdown is not rendered, and files other than images are offered as downloads, never run.
What is next#
- Footnotes, callouts, highlighted code and figure captions in the renderer.
- Packaging, so a website can install the renderer instead of copying it.
One person, many companies, one coin. Every project I build sends a share of its revenue back to buy $BERLIAN on the open market, and every buy is published with its transaction.
More from Gor Berlian
CNC foam-panel router: assembly in 42 pictures
42 steps, each with a picture of the whole machine and a close-up of the parts added. English and Indonesian.
1,008,000 gravity
TradJS 4.7.0 in testing: 1,902 tests and 118 browser steps on the development branch
Repository: https://github.com/7flash/TradJS · On npm today: tradjs 4.6.5 · Tested here: the 4.7.0 development branch, 19 November 2026, Bun 1.4.3 on Windows 11.

The Plain Web Stack
TradJS, sqlite-zod-orm and measure-fn: what they are, how they are tested, and when to use them. A short book, November 2026.
