MDflow for VS Code.
Visual Studio Marketplace · ProBring your MDflow workspace into VS Code. The MDflow Workspace extension puts your workspaces, folders, and markdown documents in the Explorer sidebar — open any document as an ordinary markdown tab, edit it with the full power of the editor, and press Ctrl/Cmd + S to save it straight back to the cloud. No browser tab, no copy-and-paste, no export/import.
Once you are signed in you can:
- ›Browse your workspaces → folders → documents as a native tree, loaded on demand.
- ›Edit documents as real markdown tabs — with your themes, keybindings, multi-cursor, and the built-in preview — and save back with one keystroke.
- ›Create, rename, move, and delete workspaces, folders, and documents from the tree.
- ›Encrypt sensitive documents with a per-file password — encrypted and decrypted locally, never on the server.
The extension is free and open source (MIT). It talks to MDflow through the authenticated HTTP API, which is a Pro feature — a free account can sign in, but editing needs MDflow Pro.
Why edit MDflow markdown in VS Code?
- ›Your knowledge lives next to your code. Specs, plans, runbooks, READMEs, and notes open in the same window as the file you are editing — no context-switch to a browser.
- ›A real editor for your markdown. Multi-cursor, Vim or Emacs keybindings, find-and-replace, your color theme, the built-in markdown preview, and any markdown extension you already use — all of it works on your MDflow documents.
- ›Your cloud workspace as a sidebar tree. Everything in MDflow — every workspace, folder, and document — shows up in the Explorer, fetched lazily as you expand it.
- ›Save is one keystroke.
Ctrl/Cmd + Swrites the document back to MDflow. Native dirty-state, undo, and tab management all behave exactly as they do for a local file. - ›Client-side encryption, in the editor. Encrypt a document with a password that never leaves your machine; the server only ever stores ciphertext.
- ›One account, every surface. The same documents you reach on the web, on mobile, over the API, and through the MCP server — now in your editor too.
Install the extension
Find MDflow Workspace in the Extensions view
Open the Extensions view (Ctrl/Cmd + Shift + X), search for MDflow Workspace, and click Install. Or install it straight from the Visual Studio Marketplace.
Open the MDflow view
A new MDflow view appears in the Explorer sidebar. Open it and click Sign in to MDflow — or run MDflow: Sign In from the Command Palette (Ctrl/Cmd + Shift + P).
Connect your MDflow account
Choose how to connect. Either way, your credentials are stored in VS Code's encrypted Secret Storage — never in a settings file or in plain text on disk.
| Field | What to enter |
|---|---|
| Sign in with browser | Runs an OAuth sign-in in your browser and returns to VS Code automatically — no token to copy. The recommended path. |
| Paste a Personal Access Token | Create a token (mdf_…) at mdflow.cz/settings and paste it. Useful for headless or restricted setups. |
Pro plan required until you upgrade to Pro (€4.99/month, 7-day free trial).MDflow: Sign Out clears the stored credentials and any cached encryption keys, and empties the tree back to the welcome view.Browse, edit, and save
Expand your workspace
The tree loads on demand: expand a workspace to list its folders (nested as deep as you like), and a folder to list its documents. A Refresh action re-fetches the tree; there is no background polling.
Open a document
Click any document to open its body as a markdown editor tab, backed by a virtual mdflow: file system. Everything you expect from a local .md file works — syntax highlighting, the Ctrl/Cmd + Shift + V preview, folding, and dirty-state indicators.
Save back to MDflow
Press Ctrl/Cmd + S. The document is written back to MDflow immediately. Bodies over 500 KiB are rejected before the request is sent, with a clear message.
Manage your whole workspace from the tree
The tree's context menus give you full CRUD — the same operations as the web app, without leaving the editor.
- ›Workspaces — create, rename, and delete (deleting a workspace removes every folder and document inside it; the last workspace cannot be deleted).
- ›Folders — create, rename, move to another folder in the same workspace, and delete.
- ›Documents — create (opens the new file for editing), rename, move to another folder, and delete.
MDflow auto-disambiguates duplicate names with a numeric suffix; the tree always shows the name the server returned, not the one you typed.
Encrypt sensitive documents
Encrypt a document's body with a per-file password, straight from the editor title bar or the Command Palette. MDflow's server only ever stores ciphertext (mdflow-enc:v1:…); your password and plaintext never leave your machine.
- ›Transparent editing. Opening an encrypted document prompts for the password once, then it reads and edits as normal markdown;
Ctrl/Cmd + Sre-encrypts on save. - ›Cross-client by design. It is the same format as the web app and the mdflow-crypt CLI (PBKDF2-600k → AES-256-GCM), so a document encrypted in one opens in the others.
- ›Lock, unlock, and remove. Forget the cached password (Lock), re-enter it (Unlock), or store the body back as plaintext (Remove Encryption) — the actions shown always match the document's current state.
How it works, and what to expect
- ›A live API client, not a sync engine. The extension reads and writes your documents through MDflow's HTTP API on demand. There is no local cache and no offline mode — saving requires a connection.
- ›Last write wins. There is no conflict resolution: if you edit the same document elsewhere at the same time, the most recent save is the one that sticks. MDflow's own version history keeps every prior version on the web.
- ›One account at a time, markdown documents only (up to 500 KiB each). Sharing, collections, and workspace search stay in the web app.
- ›Point it at localhost. The
mdflow.baseUrlsetting lets you develop against a local MDflow server; it defaults tohttps://mdflow.cz.
Troubleshooting
| Symptom | Cause & fix |
|---|---|
Pro plan required on every action | The MDflow API is a Pro feature. Upgrade to Pro — sign-in works on a free account, but reading and editing does not. |
| The tree is empty after sign-in | Run Refresh from the view's title bar. A brand new account starts with a sample folder and a Readme; create a workspace if you have none. |
| Save is blocked | A document body cannot exceed 500 KiB — the limit is enforced before the request is sent. Split very large documents. |
| Rate-limited | The API allows 60 requests per minute. The extension loads lazily and stays well under this; if you hit it, wait the few seconds the message indicates and retry. |
| Signed out unexpectedly | A token was revoked or a session expired. Run MDflow: Sign In again — OAuth refreshes silently when it can. |