← BACK TO PROJECTS
CASE STUDY 2026

Glyph - Markdown Editor

Glyph opens any markdown file on your disk as a formatted page you can type on, with no vault to set up. It also reads PDFs and EPUB books, and it can bring a folder of notes to your phone. I built it for the pile of .md files my research produces, then published it on GitHub under the MIT license.

VIEW ON GITHUB
PROJECT DETAILS
DURATION
IN DAILY USE
TOOLS
OBJECTIVE-CWEBKITC++NODE.JSPDF.JSCLAUDE CODE
PERSONAL PROJECT
Glyph - Markdown Editor
THE CHALLENGE

Thousands of files nothing opens properly

AI tools produce markdown by the pile. My archive holds over 57,000 files, and thousands of them live outside any Obsidian vault: READMEs, stray notes, project documents. A text editor shows the raw asterisks, and a vault wants every file moved in first.

THE SOLUTION

An editor that respects the file

Double-click any markdown file and it opens as a formatted page you can type on, while the file updates underneath. Before you edit, Glyph checks that a save would keep every word. A file it can't write back whole stays read-only on the page and editable in the raw view, so nothing you wrote gets lost.

PROCESS 01

Research & Definition

  1. 01Started from my own archive: what files I have, how many live outside a vault, what syntax they actually use.
  2. 02Built the native Mac app with nothing but Apple's command line tools.
  3. 03Measured saving on 264 of my real files, then added a guard for the ones that can't come back whole.
  4. 04Treated every note as untrusted input, with a test suite of hostile files.
  5. 05Ported one interface to Windows, Linux, the browser and the phone.
  6. 06Added PDFs and EPUB books, and published everything on GitHub under MIT.
Glyph - Markdown Editor — research and discovery process
COLOR SYSTEM
Rose
Gold
Teal
Lavender
Paper
Slate
TYPOGRAPHY SELECTION
San Francisco (system)

The Mac's system font, so the app feels at home because it is native.

SF Mono

Code blocks and the raw view, where the file shows exactly as it sits on disk.

2.3 MB
the whole Mac app
3
operating systems, native on each
13
test suites on every change
MIT
open source on GitHub
THE PAGE

The formatted page is the editor

Click anywhere and type. A heading takes its color the moment you write ##, a checklist appears at - [ ], and bold and highlights form as you close them, while the markdown file updates underneath. One click flips to the plain text whenever you want it.

Glyph on the Mac with a research note open, headings in rose, gold and teal
MAC APP

A Mac app the size of a photo

2.3 MB, built with Apple's own tools, so it launches instantly. Every file opens as a tab in one window. Headings run rose, gold, teal and lavender so a long document reads like a map, and the raw view keeps the same colors, with line numbers.

Glyph on a phone, showing a note with color-coded headings and a callout
PHONE

Your notes, on your phone

A small server on your computer brings a folder of notes to your phone, with the full editor and a folder tree. There is one copy of every file, so an edit on the phone is already on disk, and the app sits on your home screen with its own icon.

BOOKS

PDFs and books in the same window

PDFs open beside your notes, scans included. EPUB books open a chapter at a time in your own type, with settings for size, font, spacing, margins and page color, and each book remembers your place.

Glyph - Markdown Editor — design mockup 1 of 2
Glyph - Markdown Editor — design mockup 2 of 2
PROCESS 02

Iteration & Refinement

Every save is checked first

Before a file becomes editable, Glyph renders it, asks what it would write back and compares the two. On 264 of my real files, 248 opened editable and the other 16 stayed protected on the page, open in the raw view.

One interface, from Mac to phone

The whole interface is one HTML file, and each platform is a thin native shell around it: Mac, Windows and Linux, a single self-contained file for any browser, and a server that brings a folder to your phone.

Glyph - Markdown Editor — iteration and refinement
WHAT SHIPPED
Native Mac app
Windows, Linux, browser and phone builds
PDF and EPUB reading
13 test suites in CI
VIEW ON GITHUB

OTHER CASE STUDIES

VIEW ALL
Eleleth - Editorial System — case study
PERSONAL PROJECT

Eleleth - Editorial System

→
Transcript Desk - Video Research — case study
PERSONAL PROJECT

Transcript Desk - Video Research

→
Visual References - Technique Taxonomy — case study
PERSONAL PROJECT

Visual References - Technique Taxonomy

→