Your markdown library,
read beautifully.
mDocs opens .md files straight from your machine — or connects to a local server to browse cloned GitHub repos. Pick a folder, clone a repo, then read with syntax-highlighted code and a table of contents that follows you down the page.
Local file picking requires a Chromium browser (Chrome, Edge, Brave, Arc).
Two ways to open docs
Browser files
Use the File System Access API to open a local folder or pick individual files. No install required — just click Open viewer above and pick your folder.
- No installation needed
- Live-reloads on file save
- Chromium browsers only
Local server + GitHub repos
Run the mDocs server locally, then clone any public GitHub repo straight from the viewer. The server lives at 127.0.0.1:4873 — your docs never leave your machine.
Start the server
- Clone any public GitHub repo
- Works in any modern browser
- Private repos via
GITHUB_TOKEN
Everything you need to read docs
Open anything
Pick a folder or individual files directly from your machine. Mix browser sources and cloned repos side by side.
Clone GitHub repos
Run the local server, paste a GitHub URL, and browse any public repo's docs without leaving the viewer.
Project switcher
Switch between multiple open folders and repos in one click. Each project shows only its own file tree.
Shiki-powered code
VS Code-grade syntax highlighting with one-click copy. Light and dark themes baked in.
Keyboard first
s toggles the sidebar, a / d move between files. Stay on the home row, stay in flow.
Live reload
Edits in your editor appear within seconds for local files. Hit the refresh dot when you can't wait.
Read like Medium
Generous line height, serif blockquotes, and frontmatter rendered as a clean metadata card.
Light by default
Crisp light theme out of the box. Flip to dark with one click. Preference is remembered.
Fully offline
Documents never leave your machine. No uploads, no tracking, no account required.
Nothing leaves your machine.
mDocs reads files via the File System Access API and a local server that binds to 127.0.0.1only. Your documents are never uploaded anywhere. File handles are remembered locally so you don't have to re-pick on every visit.