$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→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
- 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
// A browser warning protects you before leaving 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 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 a real workspace
Folders, collections, search and import keep large markdown libraries tidy.
$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
- Automatic name disambiguation — appends (2), (3), and so on
- New accounts get a starter workspace with a Readme introduction
$mdflow mkdir
Folders & context
- Create, rename and delete folders; collapse state is remembered
- 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
// Folders are intentionally flat — nested folders are not offered.
$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
- 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 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
- 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 30 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)
- Or run the downloadable local server over stdio
- Works with Claude Code, Claude Desktop, Cursor, Codex and the OpenAI Responses API
- Full 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 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
$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
- 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 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]5 markdown files
- [x]5 image uploads
- [x]Public sharing links
- [x]Commenting
Pro€4.99/ month
- [x]Unlimited 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
- Version history or document revisions
- Tags
- Nested folders
- 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 5 markdown documents and 5 uploaded images, with public sharing, collections, comments and encryption. Pro removes 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 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. 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 print-ready PDF, or append .md to a share URL for raw markdown. Nothing is locked into a proprietary format.
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.