$code --install-extension DataOps.mdflow-vscode

MDflow for VS Code.

Visual Studio Marketplace · Pro

Bring 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 vscode

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 + S writes 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

Install the extension

1

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.

VS Code — Extensions
MDflow Workspace
>_
MDflow Workspace
Browse and edit your MDflow markdown · DataOps
Install
Illustration — the extension in the Extensions view.
2

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).

$sign in

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.

FieldWhat to enter
Sign in with browserRuns an OAuth sign-in in your browser and returns to VS Code automatically — no token to copy. The recommended path.
Paste a Personal Access TokenCreate a token (mdf_…) at mdflow.cz/settings and paste it. Useful for headless or restricted setups.
MDflow Pro required: The extension reads and writes through MDflow's HTTP API, which is Pro-gated. A free account can sign in, but every request returns Pro plan required until you upgrade to Pro (€4.99/month, 7-day free trial).
Sign out anytime: MDflow: Sign Out clears the stored credentials and any cached encryption keys, and empties the tree back to the welcome view.
$browse + edit

Browse, edit, and save

1

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.

VS Code — Explorer
MDflow
Personal
Specs
architecture.md
api-keys.md
Meeting notes
Illustration — workspaces, folders, and documents in the Explorer (🔒 marks an encrypted document).
2

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.

3

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.

$new · rename · move · delete

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

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 + S re-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.
No password recovery: Encryption is end-to-end: a forgotten password means the document cannot be decrypted. Save it in a password manager. Encrypted documents are also excluded from MDflow search and are opaque to the API and AI agents.
$how it works

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.baseUrl setting lets you develop against a local MDflow server; it defaults to https://mdflow.cz.
Using Cursor, Windsurf, or another editor?: Cursor and other VS Code-compatible editors install the same extension from Open VSX. See the Cursor guide →
$man troubleshooting

Troubleshooting

MDflow for VS Code troubleshooting: symptoms and fixes
SymptomCause & fix
Pro plan required on every actionThe 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-inRun 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 blockedA document body cannot exceed 500 KiB — the limit is enforced before the request is sent. Split very large documents.
Rate-limitedThe 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 unexpectedlyA token was revoked or a session expired. Run MDflow: Sign In again — OAuth refreshes silently when it can.