VerbaDraw for VS Code
Open any Markdown file as a live document with editable Mermaid diagrams. Write prose, and drag,
connect, collapse and restyle your flowcharts, sequence, class, ER and state diagrams right on the
canvas. Every change is written back to your .md file as plain Markdown, so it stays readable in
any editor and diffs cleanly in Git.
Pre-release. Everything stays on your machine — no account, no telemetry.
Open a file in VerbaDraw
VerbaDraw is an optional editor; your normal Markdown editor stays the default.
- Right-click a
.md editor tab → Reopen Editor With… → VerbaDraw, or
- click the VerbaDraw button in the editor title bar, or
- run VerbaDraw: Open Current File from the Command Palette.
VerbaDraw: New Document opens a new, unsaved Markdown file in VerbaDraw; save it with
Ctrl+S like any new file.
What you get
- Document and diagram side by side. A reading/editing view of your Markdown with headings,
tables, callouts, task lists and code blocks, a raw Markdown (code) view, and a diagram canvas.
- Five editable diagram types: flowchart, sequence, class, ER and state. Drag nodes, add and
connect shapes, collapse groups, change styles — the Mermaid source in your file updates.
- Other Mermaid diagram types (pie, gantt, mindmap, …) render read-only.
- Export the document as Markdown, HTML, SVG, PNG, JPG or PDF, or one diagram as SVG, PNG or
.mmd — through VS Code's Save dialog, next to your file.
- Themes: "Follow VS Code" by default (it switches with your VS Code theme, including High
Contrast), or one of VerbaDraw's own palettes.
- Repository-friendly: images with a relative path (like
img/diagram.png) show, and relative links open — a
.md link in VerbaDraw, other files in VS Code; a link that leaves the workspace asks first.
- Your file stays yours: VerbaDraw adds nothing to it (no hidden ids) and keeps its line
endings. Diagram layout, block colours and folded headings are remembered per file.
- Undo and save behave like VS Code: one Ctrl+Z undoes once, and saving right after typing
keeps every keystroke.
Keyboard shortcuts in VS Code
VS Code's own keys win (a webview passes every key press to VS Code too, so a shared key would do
two things). Where the web app uses a key VS Code also uses, the extension uses another one:
| Action |
Web app |
VS Code extension |
| Inline code |
Ctrl+ | Ctrl+Alt+ |
|
| VerbaDraw command palette |
Ctrl+Shift+P |
Ctrl+Alt+P, or VerbaDraw: Show Commands |
| Search nodes |
Ctrl+K |
none (in the VerbaDraw palette) |
| Settings |
Ctrl+, |
none (the gear, or VerbaDraw: Open Settings) |
| Edit / View mode |
Ctrl+E |
Ctrl+Alt+E, or VerbaDraw: Toggle Edit / View Mode |
| Table of contents |
Ctrl+\ |
Ctrl+Alt+\ |
| Export |
Ctrl+Shift+E |
none (the Export menu, or VerbaDraw: Export Document) |
| Strikethrough |
Ctrl+Shift+X |
Ctrl+Alt+X |
| Copy diagram as Mermaid |
Ctrl+Shift+C |
Ctrl+Alt+Shift+C |
| Bold |
Ctrl+B |
none (the selection toolbar) — Ctrl+B toggles VS Code's Side Bar |
| Find next / previous |
Ctrl+G / Ctrl+Shift+G, F3 / Shift+F3 |
F3 / Shift+F3 |
| Toggle VerbaDraw / text view |
— |
the editor-title button (no default key; bind verbadraw.toggle) |
Any of them can be rebound in VerbaDraw's Settings → Shortcuts; the VerbaDraw: commands can
be bound in VS Code's Keyboard Shortcuts editor.
Privacy and trust
- No telemetry, no account. The extension sends nothing about you or your files anywhere. A
check on the built extension fails if analytics, error reporting or a cloud backend ever get
bundled in.
- What does go over the network: images and link favicons that your own documents point to
are loaded from their sites when shown (with no referrer). Nothing else.
- Exports are written only where you choose in the Save dialog.
- Restricted Mode and virtual workspaces are supported. The extension runs no code from your
workspace and reads files only through VS Code's document and file-system APIs.
Known limitations
- Only the Inter font ships with the extension, so Settings → Fonts offers Inter only.
- One VerbaDraw editor per file at a time.
- Diagram layout, block colours and folded headings are remembered for the 200 most recently
opened files. Renaming or moving a file inside VS Code keeps them; a rename made outside VS Code,
or the first save of an untitled document, starts fresh.
- Exported HTML/PDF include relative images only when they can be read at export time.
Feedback
This is a pre-release. Problems and ideas are welcome through the product's support channel.
| |