DocuFlow
View, edit and diff Markdown rendered, inside VS Code.
tructured text is everywhere: specs, plans, docs, agent memory. VS Code's default is still to edit and diff it as source lines.
- DocuFlow shows the document with its structure and layout, so reading, skimming and understanding take a fraction of the effort.
- Knowing what changed since the last iteration, and what the next one proposes, helps with almost any work. In DocuFlow this awareness is a first-class citizen, not an afterthought. Diffing does add visual clutter so we're looking for the right balance and seamless switching between full diff detail and an undistracted view of the document.
What you get
- Changes inside the document. Side by side or inline, word-level highlights inside paragraphs, list items and table cells. Tables stay tables, images stay images. The diff recomputes as you edit.
- As much diff as you want. Compare the working tree against the index,
HEAD or nothing, per tab. Nothing gives you the undistracted document; one shortcut brings the full detail back.
- Git integration. Changed Markdown files listed in the Source Control view with one-click stage and unstage, a CodeLens on changed files, Explorer and Source Control context menus, and
git difftool support from the terminal.
Getting started
- Open a Markdown file inside a git repository.
- Run DocuFlow: Open in DocuFlow (
Shift+Alt+M), or right-click the editor tab and choose Open With… › DocuFlow Diff Preview.
- Use the chip at the top of the document to pick the base and to switch between Edit (inline) and Review (side by side). The two buttons beside it open the same file in VS Code's text editor or text diff, cursor carried.
Changed Markdown files also appear under DocuFlow Markdown Diffs in the Source Control view.
Commands
| Command |
Default shortcut |
| DocuFlow: Open in DocuFlow |
Shift+Alt+M |
| DocuFlow: Open in Text Editor |
Shift+Alt+Cmd+T / Ctrl+Shift+Alt+T |
| DocuFlow: Open in Text Diff |
Shift+Alt+Cmd+D / Ctrl+Shift+Alt+D |
| DocuFlow: Edit / Review |
Shift+Alt+Cmd+E / Ctrl+Shift+Alt+E |
| DocuFlow: Compare Against… |
Shift+Alt+Cmd+B / Ctrl+Shift+Alt+B |
| DocuFlow: Next Change / Previous Change |
Alt+F5 / Shift+Alt+F5 |
| DocuFlow: Open Diff… |
Ctrl+Alt+D |
Select text and comment; threads are kept per file in your workspace.
Early preview: Claude Code can leave remarks next to the words they are about. On first start DocuFlow offers to install a small skill into ~/.claude/skills. The remarks are stored in .aidiff.jsonl at the repository root, which DocuFlow registers in the clone's .git/info/exclude, so nothing is added to the repository. Both steps are also available as commands: DocuFlow: Install Agent Comment Skill for Claude Code and DocuFlow: Add Agent Comment Convention to AGENTS.md.
Requirements
- VS Code 1.133 or later.
- A git repository for diffs. Outside a repository DocuFlow still works as a rendered editor.
Preview notes
DocuFlow is in alpha. Two things to know before you rely on it:
- Saving re-serializes the file. The editor writes the whole document back from its own model. Hard-wrapped paragraphs are joined into single lines and raw HTML blocks are dropped. Check the diff before you commit an edit made in DocuFlow.
- Diffs opened by VS Code itself. A Markdown diff opened from a Source Control click or the Timeline arrives as VS Code's text diff. DocuFlow: Open in DocuFlow (
Shift+Alt+M) takes the pair apart into one DocuFlow editor comparing the two versions. To skip that step, map *.md to DocuFlow in the workbench.diffEditorAssociations setting: VS Code then opens such a diff as two DocuFlow editors side by side, and the extension folds them into one.
Feedback
Tell us what annoys you, what is missing and what is pointless in the Q & A tab of this page.
License
Proprietary. See LICENSE.txt.
