$mdflow features --all
Everything MDflow can do.
From a polished markdown editor to a full HTTP API and MCP servers for AI agents — here is the complete set of MDflow features, in one place. Portable markdown for people and machines.
mdflow --features
$ mdflow features --all→editorlive preview · split view · GFM→workspacefolders · collections · search · export→sharingpublic · private · comments→securityclient-side AES-256 encryption→automationHTTP API · MCP · agent discovery→clippercapture the web as clean markdown
// jump to
$mdflow edit
Write markdown in a real editor
A fast, browser-based Monaco editor with live preview — no desktop app to install.
$mdflow edit
Editor & views
- Monaco-powered editor with markdown syntax highlighting
- Three views: Edit, Split (source + preview), and Preview
- Live rendered preview while you type
- Full GitHub Flavored Markdown — headings, tables, task lists, code blocks, strikethrough and more
- Link to another document with an @mention — type @, pick a doc, and a live internal link is inserted
- Focus mode hides the sidebar and toolbar for distraction-free writing
- Built-in markdown help panel with practical examples
- Automatic light and dark themes that follow your system
- Editable title, Cmd/Ctrl+S to save, and a visible unsaved-changes indicator
- Discard to restore the last saved server version
// Optional typewriter sound feedback, and a browser warning before you leave a page with unsaved changes.
$mdflow recover
Drafts & offline resilience
- Unsaved edits are kept locally in the browser as you work
- Drafts survive page reloads and navigation between documents
- Documents with a recoverable draft are flagged in the sidebar
- Stale drafts are discarded when the server copy has changed
- Keep editing offline — an offline banner appears when you disconnect
- Saves retry automatically when connectivity returns
$mdflow versions
Version history & autosave
- Every saved change captures the previous version automatically — across the editor, the API and MCP writes
- Browse past versions and see a line-by-line markdown diff against the current document
- Restore any version as the new latest — non-destructive, so nothing is lost
- History is private to you, kept 30 days or the last 300 versions, and works with encrypted documents
- Autosave saves a few seconds after you stop typing — toggle it per document
// Version history and autosave are Pro features.
$mdflow paste-image
Images in markdown
- Drag a file in or paste from the clipboard, right in the editor
- Markdown image syntax is inserted for you, with visible upload progress
- JPEG, PNG and WebP up to 20 MB, resized to 1024 px in the browser
- Uploads are private by default — public only when a public document references them
- Unused images are cleaned up on removal, deletion and duplication
- Externally hosted images referenced by URL render too
// Image upload is desktop-only; mobile readers can still view uploaded images.
$mdflow ls
Organize across workspaces
Separate projects into their own workspaces, then keep each tidy with folders, collections, search, import and export.
$mdflow workspace
Workspaces
- Keep separate workspaces for different projects or areas of life — say Work, Personal and a side project
- Each workspace has its own folders, documents and search
- Switch the active workspace from the sidebar; your choice is remembered
- Create, rename and delete workspaces — new accounts start with a ready-made default one
- Move a folder, with its documents and subfolders, between workspaces
- Collections still span workspaces, so a shared set can pull from any of them
// Workspaces are on every plan, with no limit on how many you create.
$mdflow new
Documents
- Create documents inside folders and rename them inline
- Move, duplicate (with referenced images) and delete with confirmation
- Favorite important documents for a dedicated sidebar section
- Download any document as .md or export a print-ready PDF
- Export a whole workspace as a .zip — folders, raw markdown and images, with links rewritten so it opens in Obsidian, VS Code or on GitHub
- Automatic name disambiguation — appends (2), (3), and so on
- New accounts get a starter workspace with a Readme introduction
$mdflow tasks
Tasks
- A /tasks view gathers every markdown checkbox across the workspace into one list, grouped by folder and document
- Filter by status, due date (due, today, this week, next week) and owner — each with a live count — plus a text search
- Check off, rename, set a due date or assign an owner inline; every edit writes back into the source markdown
- Optional (YYYYMMDD) due date and (email) owner right after the checkbox; indented subtasks nest
- Add tasks inline under a document or with a top-level quick-add; collapse per document or all at once
// Free on every plan and scoped to the active workspace. Encrypted documents are counted and skipped.
$mdflow mkdir
Folders & context
- Create, rename and delete folders; collapse state is remembered
- Nest folders inside folders, and reorganize with a Move to… picker
- Add an optional description to each folder
- Descriptions help people — and give AI agents high-value context over MCP
- Deleting a folder removes its documents after a confirmation warning
$mdflow collect
Collections
- Group related documents independently of how they are filed
- Add a single document or a whole folder; a document can join many collections
- Share a collection by public read-only link, with optional commenting
- Or share it privately with specific people by email
- Readers get a clean reader with a file list and per-document preview, source, split, download and PDF
$mdflow grep
Workspace search
- Search across document titles and markdown body text
- See highlighted snippets and the containing folder for every result
- Title matches are prioritized; jump straight to a document
- Encrypted documents are excluded — the server cannot read them
$mdflow import
Markdown import
- Import .md and .markdown files by drag-and-drop or file picker
- Import many at once, into a folder or an auto-created timestamped folder
- Drop a whole folder — subfolders and all — to rebuild its tree as nested folders
- Source is preserved as editable documents; duplicates are disambiguated
- Unsupported or oversized skipped files are reported
// Imported markdown files are limited to 500 KB each.
$mdflow github
GitHub integration
- Connect a GitHub account to a workspace, and disconnect anytime
- Browse your repositories, their branches and folders in the sidebar
- Open, create, rename and delete markdown files in the same editor
- Commit-on-save with an editable message, attributed to your own GitHub account
- A conflict warning if the file changed on GitHub — never a silent overwrite
// Live proxy — files are never copied into MDflow. On every plan.
$mdflow encrypt
Keep private things private
Client-side encryption and strict ownership checks mean the server never sees what it should not.
$mdflow encrypt
Document encryption
- Encrypt any document with a password, right in the browser
- AES-256-GCM with a key derived from your password — fully client-side
- The server only ever stores ciphertext, never the text or the password
- Unlock to read and edit; the key is remembered on the device
- Lock on demand, or remove encryption to return to plain markdown
- Only the body is encrypted — titles and folder structure stay readable
- Shared encrypted documents show a password gate for readers
// If the password is lost the document cannot be recovered — save it in your password manager.
$mdflow audit
Privacy & security
- Workspace routes require authentication; reads and writes are ownership-checked server-side
- Encrypted contents are excluded from search and unreadable through any share link
- Anonymous links expose only the title, body, commenting and referenced public images
- Comment access requires the active random share URL — a document ID alone will not do
- Public links use random 64-character slugs; disabling invalidates them permanently
- API tokens can be revoked immediately; API responses are Cache-Control: no-store
$curl /api/v1
Programmable for scripts & AI agents
A documented HTTP API, Personal Access Tokens and two MCP servers make your workspace fully scriptable — plus machine-readable discovery files for agents.
$mdflow token
Personal Access Tokens
- Create named tokens in settings; copy each one once at creation
- Review name, creation date, last-used date and status
- Revoke permanently; revoked records are retained for audit
- Only token hashes are stored, never plaintext tokens
// Tokens authenticate both the API and the remote MCP server. Pro required.
$curl /api/v1
HTTP API
- Versioned JSON API under /api/v1, authenticated with a bearer token
- Manage workspaces, folders and documents — list, create, rename, describe and delete
- Full CRUD for folders and documents, plus move and body replacement
- Toggle public sharing and commenting; manage private email shares
- Folder descriptions included so external tools understand context
- Exclude document bodies to keep list payloads small
- OpenAPI 3.1 at /openapi.json; human-readable docs at /docs/api
- Rate limited to 60 requests per minute; responses are non-cacheable
// API access is a Pro feature.
$mdflow mcp
MCP servers
- Hosted remote server over HTTP at /api/mcp — no local install (Pro)
- Connect Claude.ai and ChatGPT with a browser OAuth sign-in — no token to paste
- Or run the downloadable local server over stdio
- Works with Claude Code, Claude Desktop, Cursor, Codex and the OpenAI Responses API
- Full workspace, folder and document tools, sharing management and setup help
- Ask for context on a topic — it ranks folder descriptions first
- Returns both readable markdown context and structured content
$cat llms.txt
Agent & AI discovery
- llms.txt — a discovery index pointing agents to docs, pricing, API and MCP
- docs.md — a one-page control manual for every tool and endpoint
- pricing.md — machine-readable pricing an agent can read
- /.well-known/agent-card.json — an A2A discovery beacon
- Append .md to any share URL for raw markdown with YAML frontmatter
$mdflow clip
Capture the web as clean markdown
The MDflow Web Clipper saves and highlights any web page straight into your workspace as durable markdown.
$clip --page
Clip any page
- Chrome and Chromium (Brave, Arc, Edge), Firefox on desktop and mobile, and Safari on macOS, iOS and iPadOS
- Extracts the main article and strips navigation, ads and clutter
- Clip the full article, a text selection, or your saved highlights
- Edit the name and add notes; pick the destination folder live from your workspace
- Clip from a popup, side panel, in-page clipper, right-click menu or keyboard shortcut
$clip --highlight
Web page highlighter
- Highlight text, individual elements, or whole pages — persists across visits
- Keep highlights inline, replace the content with them, or save without
- Manage highlights in a dedicated view with search and sorting; undo and redo
- Delete highlights by page, by domain, or all at once; export to a file
$clip --template
Templates & properties
- Multiple templates, auto-selected by URL pattern or schema.org data
- Customize the name, folder, content and typed frontmatter properties
- Template logic with conditionals, loops and variables; inline validation
- Preset, meta, CSS-selector and schema.org variables, plus a large filter library
- Import, export and copy templates and property sets
$clip --ai
AI interpreter
- Natural-language prompt variables extract or transform page data with an LLM
- Bring your own provider and key: Claude, OpenAI, Gemini, DeepSeek, Perplexity, OpenRouter, Azure, Hugging Face, Meta, Ollama
- Optionally auto-run on templates that use prompts; live token counter
- Requests go straight to your provider — MDflow stores nothing
// Connects over the same Personal Access Token; every clip creates a new document.
$mdflow login
Use it anywhere, sign in your way
A responsive workspace, a VS Code and Cursor extension, and four sign-in options meet you on any device.
$mdflow open
Responsive workspace
- Works on desktop, tablet and mobile with collapsible drawer navigation
- Mobile-friendly document editing and preview
- Split view simplifies to a single pane on narrow screens
- Resizable desktop sidebar with the width remembered, keyboard-accessible
$code --install mdflow
VS Code & Cursor extension
- The MDflow Workspace extension puts your workspaces, folders and documents in the editor's sidebar
- Open any document as a native markdown tab and Cmd/Ctrl+S to save it straight back to MDflow
- Full create, rename, move and delete, plus per-file client-side encryption
- Sign in with OAuth or a Personal Access Token, kept in the editor's encrypted secret storage
- One extension, two registries: VS Code Marketplace and Open VSX (Cursor, Windsurf, VSCodium)
// The human editor for the same markdown your agents read over MCP. Editing requires Pro.
$mdflow login
Account access
- Sign in or create an account with Google, Apple, GitHub or Microsoft
- See your name, email and profile image in the sidebar
- Signing out clears locally stored unsaved drafts
- Delete your account and all your data permanently from settings, anytime
- Public Terms and Privacy pages, plus a support link in settings
$mdflow plan
Free trial, basic free tier, simple subscription
Public sharing, collections, comments and encryption are included on both plans. Pro adds version history and autosave, private sharing by email, Personal Access Tokens, the HTTP API and the remote MCP server — and starts with a 7-day free trial, with no charge until it ends and the option to cancel anytime.
Freefree forever
- [x]100 markdown files
- [x]5 image uploads
- [x]Public sharing links
- [x]Commenting
Pro€4.99/ month
- [x]10,000 markdown files
- [x]10,000 image uploads
- [x]Full HTTP API access
- [x]Remote MCP server
// no card to start · fair-use applies
$cat roadmap.txt
Not here yet
We would rather be straight with you. These are not offered today — so you know exactly what you are choosing:
- Real-time multi-user collaborative editing
- Comment replies, approval workflows or preview-anchored annotations
- Tags
- Trash, soft-delete or restore
- Custom public share URLs
- Mobile image upload
- Nested collections, or collections of collections
$mdflow help
Frequently asked questions
Is MDflow free?
Yes. The free plan includes up to 100 markdown documents and 5 uploaded images, with public sharing, collections, comments and encryption. Pro raises those limits and unlocks the developer tools for €4.99/month, starting with a 7-day free trial.
Do I need to install anything?
No. MDflow runs entirely in your browser. The optional Web Clipper browser extension and the optional local MCP server are the only downloads, and both are optional.
Can I keep separate workspaces for different projects?
Yes. Create as many workspaces as you like — say Work, Personal, and a side project — each with its own folders, documents and search. Switch between them from the sidebar, move a folder (with its documents) from one to another, and share a collection that spans several. Workspaces are on every plan, with no limit.
Can MDflow read my private documents?
Workspace routes require authentication and every read and write is ownership-checked. Encrypted documents are encrypted in your browser with AES-256-GCM, so the server only ever stores ciphertext — never the text or the password.
Can AI agents and scripts use my workspace?
Yes. A documented HTTP API, a hosted remote MCP server, a downloadable local MCP server, and machine-readable discovery files let agents such as Claude, Cursor and Codex read and write your workspace with a Personal Access Token — and Claude.ai and ChatGPT can connect with a browser OAuth sign-in instead, no token to paste. These developer tools require Pro.
How does sharing work?
Publish a document or collection at an unguessable read-only link that anyone can open without an account, or share privately with specific people by email. Readers can comment on passages and clone their own independent copy.
Does MDflow work on mobile?
Yes. The workspace is responsive for reading and writing on phones and tablets. Image upload is currently desktop-only, but uploaded images are still viewable on mobile.
Can I get my markdown out?
Always. Your content is plain markdown: download any document as .md, export a whole workspace as a .zip of markdown and images that opens in any editor, export a print-ready PDF, or append .md to a share URL for raw markdown. Nothing is locked into a proprietary format.
Can I edit the markdown in my GitHub repositories?
Yes. Connect a GitHub account to a workspace and edit the markdown in your repositories in place: browse repositories, branches and folders in the sidebar, then create, edit, rename, delete and commit markdown files straight back to the repo. Saving commits with an editable message attributed to your own GitHub account, and a conflict warning instead of a silent overwrite. Files are read and written live and never copied into MDflow, so the repo and its git history stay the source of truth. It's on every plan.
Can I edit my MDflow documents from VS Code or Cursor?
Yes. The MDflow Workspace extension puts your workspaces, folders and documents in the editor's sidebar: open any document as a native markdown tab, edit it, and press Cmd/Ctrl+S to save it straight back to MDflow, with full create, rename, move and delete and per-file client-side encryption. It is one extension published to two registries — the VS Code Marketplace, and Open VSX for Cursor, Windsurf and VSCodium. Sign in with your browser (OAuth) or a Personal Access Token; because it edits over the MDflow API, editing requires Pro.
What is the MDflow Web Clipper?
A companion browser extension for Chrome, Firefox and Safari that captures any web page into your workspace as clean markdown, with highlighting, templates and optional AI-assisted extraction.
$mdflow init
Markdown built for people and agents.
Sign in with Google and create your first document in seconds. The free plan needs no card.