skip to content
$mdflow
$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.

start free →see pricing

100 documents free, no card. Pro from €4.99/month.

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 · n8n · agent discovery
→clippercapture the web as clean markdown
→mobilenative iPhone & iPad app

// 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
  • Enter carries a list on — bullets, numbered items and task lists continue themselves, and a second Enter leaves the list
  • Paste a URL over selected text and the markdown link is written for you
  • A live status line with word count, character count and estimated reading time
  • 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 goto

Navigation & shortcuts

  • Quick open — press Cmd/Ctrl+K to jump to any document by title, matched in the browser as you type
  • Loose matching: bmn finds "Board Meeting Notes", and accents are ignored in both directions
  • Open it with an empty field to see the most recently edited documents and Enter back into the last one
  • Outline panel — Cmd/Ctrl+Shift+O lists the document's headings and jumps the editor and preview to any of them
  • Press ? for a dialog listing every shortcut, also in the sidebar account menu
  • Cmd/Ctrl+Shift+R re-reads the tree and the open document from the server without throwing away your editor state
  • Collapse the sidebar to a source rail with Cmd/Ctrl+\ — Documents, Tasks, Images, Shared and GitHub stay one click away

Hold Cmd/Ctrl and the shortcut appears on the control it belongs to, so you learn it where you already are.

$mdflow present

Presentation mode

  • Present any document as a fullscreen slideshow — no export and no second file
  • Slides split at every top-level # heading; headings inside code fences are ignored
  • Launch it from the sidebar tree menu, the editor header, or a shared document's reader view
  • Arrow keys, Space, Page Up/Down and Home/End move through the deck, with on-screen controls and a slide counter
  • Zoom the slide text from 50% to 250% and it is remembered for next time
  • Slides render with the same markdown formatting as the preview

Free on every plan — and readers of a shared link can present it without an account.

$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 share

Share clean documents

Publish a polished read-only page, or share privately with named people — with comments and one-click cloning.

$mdflow publish

Public sharing

  • Turn public sharing on or off independently for each document
  • A read-only link opens without an account; copy it in one click
  • Long, random URLs; disabling a link invalidates it permanently
  • Shares rendered markdown with its referenced images — the rest stays private
  • Owner identity and email stay hidden on shared pages
  • Optional commenting per document, with a friendly unavailable page for dead links
  • Signed-in visitors can clone an independent copy, including images
$mdflow share --email

Private sharing by email

  • Share a document or a collection with specific people by email
  • Choose each person's access: view only, or view and comment
  • Recipients sign in with the invited address — no public link is created
  • MDflow emails each person the private link
  • Shared items appear under "Shared with me"; track pending vs accepted
  • Revoke one person or everyone at once, instantly

Private sharing by email is a Pro feature.

$mdflow read

Reader experience

  • A clean reader view with the rendered preview by default
  • Switch between preview, read-only source and side-by-side split
  • Download the original .md or export a print-ready PDF
  • Read without signing in; sign in to comment or clone
  • Your Comment or Clone action resumes automatically after signing in
$mdflow comment

Comments

  • Attach comments to selected passages; commented text is highlighted
  • A responsive side panel on desktop, a slide-over drawer on mobile
  • Each comment shows the quoted passage, author, avatar and timestamp
  • Owners read and moderate comments from the normal editor
  • Comments are preserved when public sharing is toggled off and on
  • The panel refreshes automatically while people are discussing
$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
$n8n install n8n-nodes-mdflow

n8n automation

  • A community node, verified by n8n and installable straight from the canvas, that puts your whole workspace in front of a workflow — no code required
  • An action node with 22 operations across documents, folders, workspaces and shares
  • An MDflow Trigger node that polls for a new document, folder or workspace
  • Two-way: pull a document body into a workflow, transform it, and write it straight back
  • Wire markdown into everything else n8n connects to — forms, databases, GitHub, CRMs, Slack, email, RSS
  • Usable as a tool by n8n AI Agents, or bridge the remote MCP server with n8n's MCP Client Tool node

Free and open source, authenticated with a Personal Access Token. Requires Pro.

Set up the n8n node →
$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 log

Document Log

  • A /log activity feed of every created, edited, shared and deleted document across your workspaces
  • Each row names the actor — “you” for browser actions, or “automated · token name” for anything arriving over the API or MCP (Claude, the Web Clipper, n8n, the VS Code extension, the iOS app)
  • Click an edited row for a side-panel diff of exactly what that edit changed
  • Deleted documents keep their who, what and when — even when removed by deleting a folder or a whole workspace
  • Filter by event type and by workspace; encrypted diffs appear only after unlocking on that device

Recorded for every account and kept 30 days. Free accounts view the last 24 hours; Pro sees the full history.

$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 free native iPhone and iPad app, 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
$open MDflow.app

iPhone & iPad app

  • A free native iOS app that signs into the same account — no separate subscription and nothing to pair
  • Browse Favorites, Recents and the full folder tree, switch workspaces, and search the whole workspace by title and body
  • Read GitHub Flavored Markdown with an Edit/Preview toggle and persistent text zoom
  • Edit with debounced autosave and a live Saving / Saved indicator
  • Create, rename, move, delete and favorite documents and folders
  • A Tasks mode over the same markdown checkboxes as the web — filter, complete, and add tasks from your phone

Universal for iPhone and iPad. No tracking and no data collected.

Download on the App Store →
$share → MDflow

Capture & unlock on iOS

  • Share to MDflow — send text or a file from any app's share sheet; it queues offline and lands in your workspace
  • Open in MDflow — the system Open-With target for .md, .markdown and .txt files
  • A configurable home-screen widget that opens a chosen document, and a New Note control for the Action Button and Control Center
  • Siri and App Shortcuts: open a document, search, start a note, or append a line
  • Document titles appear in Spotlight — titles only, never bodies, and cleared on sign-out
  • Unlock encrypted documents with Face ID or Touch ID, in the same format as the web app

Capture works offline or signed out; reading and editing need a connection.

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

Install the extension →
$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
./start-freefull pricing
$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
  • An Android or macOS app — the native app is iPhone and iPad only
  • Offline reading or editing in the mobile app
$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. There are optional companions if you want them — a free iPhone and iPad app, the Web Clipper browser extension, a VS Code and Cursor extension, an n8n node and a local MCP server — but nothing is required to write and share.
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.
Can I see what agents and integrations did to my documents?
Yes. The Document Log at /log is a cross-workspace activity feed of every created, edited, shared and deleted document. Each row names the actor — “you” for actions taken in the browser, or “automated · token name” for anything arriving over the HTTP API or MCP, so you can tell an agent, the Web Clipper, n8n, the VS Code extension or the iOS app apart. Click an edited row to see a side-panel diff of exactly what changed, and deleted documents keep their history even when removed by deleting a folder or a whole workspace. It is recorded for every account and kept 30 days; free accounts view the last 24 hours and Pro sees the full history.
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, two ways. There is a free native iOS app for iPhone and iPad — MDflow Mobile Markdown on the App Store — that signs into the same account to browse, search, read, edit with autosave, work through your tasks, capture from any app's share sheet, and unlock encrypted documents with Face ID. The web workspace is also fully responsive for reading and writing on phones and tablets. Image upload is currently desktop-only, but uploaded images are viewable everywhere.
Can I automate MDflow with n8n?
Yes. The n8n-nodes-mdflow community node is verified by n8n and published on n8n Cloud, so you can add it straight from the nodes panel on the canvas. It puts your workspace on that canvas: an action node with 22 operations across documents, folders, workspaces and shares, plus an MDflow Trigger node that fires when a new document, folder or workspace appears. It reads and writes in both directions, works as a tool for n8n AI Agents, and connects with a Personal Access Token — so a form submission, a database row or an RSS item can become a markdown document, and a new document can kick off any workflow. The node is free and open source; because it uses the MDflow API, it requires Pro.
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.

./start-free →compare alternatives