A folder of small tools for Markdown.
russ.md is a static site. Every tool on it is JavaScript that runs in your browser. There is no API, no database and no login. It exists because most of the time you want one quick job done to a README and would rather not install anything or hand the file to a stranger.
Where your document goes
Nowhere. The text you paste stays in the tab. To let you come back to it, each tool saves the working document to this browser's local storage under a russ.md/ prefix. Clearing site data removes it. Nothing is sent to russ.md or anyone else.
Two things are worth knowing. Share links from the editor put a compressed copy of the document in the URL after the #, which browsers never send to a server; anyone you give the link to can read it, so treat it like the document itself. And when a preview renders an image from a URL, your browser fetches that image from wherever it lives.
There is no analytics script and no cookie. The site is served from Cloudflare's edge as static files with a strict content security policy.
One document, every tool
The tools share a working document. Open a file in Lint, fix what it finds, then use Send to in the toolbar to carry the result into Format, Contents or Stats. Tables has its own grid, and Add to document appends the finished table to the shared document.
Keyboard shortcuts
| ⌘ O | Open a file |
| ⌘ S | Save the document or result |
| ⌘ ⇧ C | Copy the result |
| ⌘ ↵ | Run the tool's main action: fix, apply, insert |
| ⌘ F | Find and replace inside an editor |
| ⌥ ⇧ S | In the editor, save the preview as a standalone HTML file |
On Windows and Linux, use Ctrl in place of ⌘. You can also drop a file anywhere on a tool page to open it.
Built with
- markdownlint the rules behind Lint
- Prettier the formatter behind Format
- markdown-it rendering for the previews and Markdown to HTML
- Turndown HTML to Markdown
- CodeMirror the text editors
- highlight.js code highlighting in previews
- DOMPurify keeps previews safe
- Papa Parse CSV import for Tables
- lz-string compresses share links
- Astro builds the site
- Archivo and Sometype Mono the typefaces, self-hosted
Source and problems
The site is open source at github.com/russmckendrick/russ-md. If a tool gives a wrong answer, open an issue with the Markdown that caused it. Made by Russ McKendrick.
Colophon
The design borrows from the pre-press proof sheet: the crop marks around each working panel, the CMYK control strip along the top of the home page and the proof-sheet mark in the logo. Markdown is the proof; the rendered page is the print. Type is set in Archivo and Sometype Mono. See the brand page for the assets.