Smart file tree
Folders without any .md inside are dimmed automatically. Your notes surface, node_modules disappears.
auto-dimmingv1.8.0 — Graph View + BacklinksWrite Markdown.
Write Markdown.
A focused Markdown workspace editor for developers, writers, and AI practitioners. Smart file tree, split-pane live preview, integrated terminal — zero bloat.
Free & open source macOS · Windows · Linux Auto-updating
getting-started
AGENTS.md
2026-08-03.md
guides/
architecture
backlinks
# Getting started
Focus on the writing — mdview
handles the tree, preview and
terminal around you.
☑ Live GFM preview, scroll-synced
☑ KaTeX math: $E = mc^2$
☐ Mermaid diagrams
```mermaid
graph LR
A[Idea] --> B[Draft] --> C[Docs]
```
Focus on the writing — mdview
handles the tree, preview and
terminal around you.
☑ Live GFM preview, scroll-synced
☑ KaTeX math: $E = mc^2$
☐ Mermaid diagrams
```mermaid
graph LR
A[Idea] --> B[Draft] --> C[Docs]
```
Getting started
Focus on the writing — mdview handles the tree, preview and terminal around you.
☑ Live GFM preview, scroll-synced
☑ KaTeX math: E = mc²
☐ Mermaid diagrams
Idea──▶Draft──▶Docs
Press Cmd+P to jump anywhere.
● ptys: 2✓ savedEN · VI
// features
Everything around the text,
out of the way
An editor first, a workbench second. The tree, the preview and the terminal exist to serve one file at a time.
Live GFM preview
Split-pane editor ↔ preview with drift-free heading-segment scroll sync. Checklists are clickable in both panes.
markdown-itMath + diagrams
KaTeX inline and block math, plus fenced ```mermaid``` blocks that lazy-load only when needed.
KaTeX · MermaidIntegrated terminal
A real PTY panel with multi-session tabs. Sessions survive panel hide/show — your shell state stays alive.
xterm.js + PTYCommand Palette
Cmd+P fuzzy file search with recents first. Prefix # to search headings across the whole workspace.
fuzzy · Fuse.jsWorkspace search
Cmd+Shift+F full-text search over every .md, powered by a multi-threaded Rust backend with highlighted snippets.
Rust coreWikilinks
Type [[ for fuzzy autocomplete across all files. Click any relative link in preview to open it as a new tab.
[[]] autocompleteDaily notes
Alt+D creates today’s YYYY-MM-DD.md with a heading template, cursor at the last line, ready to type.
journalingGraph view
A D3 force-directed map of your workspace files and internal links — drag nodes, click to jump, pan & zoom.
new in v1.8 CLAUDE.md agent
AGENTS.md agent
.cursorrules agent
Built for the AI workflow
mdview recognizes agent instruction files — CLAUDE.md, AGENTS.md, .cursorrules — and gives them a distinct bot icon so you always know where your agent’s instructions live. Backlinks show you every note that references the active file.
// v1.8.0
See your notes the way your brain does
The new D3 force-directed graph view renders every markdown file and internal link as a living network. Zoom, pan, drag nodes — click any node to open the file and expand it in the explorer.
- Interactive force simulation, zero config
- Sidebar tab + full editor-pane tab view
- Backlinks panel lists every note pointing at the active file
graph: workspace.md
// shortcuts
Keyboard-first, like a real editor
Every frequent action is one chord away. macOS and Windows/Linux maps both supported.
Save⌘S
Command Palette⌘P
Workspace search⌘⇧F
Toggle sidebar⌘B
Toggle terminal⌘J
Find in editor⌘F
Daily note⌥D
Settings (macOS)⌘,
// download
Free. Open source. Yours.
One installer per platform. The in-app updater checks silently on launch and installs new versions automatically.
macOS
Universal binary — Apple Silicon & Intel
Download .dmgad-hoc signed · Gatekeeper guide included