---
title: "00 Welcome to MDflow.md"
canonical_url: https://mdflow.cz/share/c/h0L7MvX5Cy5sST3qPnApqHOmrQ36JTVy169qJMtDMya9Kc30zm04cg9OuPSSPwvj/60fac7ea-36ff-4517-b865-3da7b696cd2d
md_url: https://mdflow.cz/share/c/h0L7MvX5Cy5sST3qPnApqHOmrQ36JTVy169qJMtDMya9Kc30zm04cg9OuPSSPwvj/60fac7ea-36ff-4517-b865-3da7b696cd2d.md
visibility: public
---

# MDflow Documentation

Everything you can do in MDflow — the web app, the companion apps, and the developer and AI interfaces.

MDflow is an online markdown workspace for people who want to write in a portable format, share clean documents with readers, and make the same knowledge available to scripts and AI agents. It lives at [https://mdflow.cz](https://mdflow.cz).

## One more thing

**And hey - you know what's great about MDflow among other things? You can generate documentations like this one on the fly and have it published automagically on your own domain .-)**

## Start here

- **Never used MDflow?** → [02 Quick Start](/doc/ee9000b7-017c-4f7c-8c74-230820fb5afa) — from a new account to a shared document in five minutes.
- **What is this thing?** → [01 Welcome to MDflow](/doc/b00ab4c8-4e44-4ced-b124-7654441968aa)
- **Free or Pro?** → [04 Free and Pro Plans](/doc/b55abc0c-ac5d-44cb-b5a5-22b3cc04a69f)
- **Connecting Claude or Codex?** → [04 Connecting Claude, ChatGPT,...](/doc/72aa97f1-fef9-4465-82fc-0a21ee327252)
- **Connecting an AI agent?** → [03 MCP Servers](/doc/aad78a27-0654-4781-b4b7-6ced0b14dbfc)
- **Something is broken?** → [03 Troubleshooting](/doc/ba04618a-7be0-4965-abe7-cfa9f686ce5c)
- **Need a human?** → [01 Support](/doc/b537e13c-ee9e-488d-a319-9c3d51db03d1)

## Contents

### 01 Getting Started

- [01 Welcome to MDflow](/doc/b00ab4c8-4e44-4ced-b124-7654441968aa) — what MDflow is and why plain markdown
- [02 Quick Start](/doc/ee9000b7-017c-4f7c-8c74-230820fb5afa) — write, save and share your first document
- [03 Signing In and Your Account](/doc/9508ea54-aedc-4790-a5b5-3107875a0ad9) — sign-in providers, settings, account deletion
- [04 Free and Pro Plans](/doc/b55abc0c-ac5d-44cb-b5a5-22b3cc04a69f) — what each plan includes

### 02 Writing and Editing

- [01 The Editor](/doc/3e67a2af-7882-4ac3-8530-993fe21bf253) — the three views, focus mode, themes
- [02 Markdown Syntax Reference](/doc/aebe9231-8a9b-49d6-9940-1efb2353284e) — the supported GitHub Flavored Markdown
- [03 Linking Documents Together](/doc/6a2085ea-444c-44ae-b9d2-43965e1ce5b6) — `@` mentions and how links behave in shares
- [04 Images](/doc/1440e5da-c790-4b50-b24b-ebe4fd6e5a6c) — drag, paste, privacy and cleanup
- [05 Saving, Autosave and Drafts](/doc/681a938a-ae3f-42cb-9b1e-5450722ac952) — saving, offline resilience, draft recovery
- [06 Version History](/doc/9c6737c5-cb49-4eb8-83c8-d9a72e36fa3c) — diffs, restore, retention *(Pro)*

### 03 Organizing Your Work

- [01 Workspaces](/doc/ffdfed0b-680d-4018-9727-f36b0f9d6cb0) — keeping projects apart
- [02 Folders and Subfolders](/doc/ee296c64-ecda-49e9-a03f-1834eb1746d1) — nesting, and the descriptions AI agents rely on
- [03 Managing Documents](/doc/141dee01-12f7-4d36-b699-a642974fd4b5) — rename, move, duplicate, favorite, download, delete
- [04 Search](/doc/43588057-54ed-4d26-84b2-d1a625c5e7ff) — what is searchable and what is not
- [05 Collections](/doc/8044ae40-6ec5-4dcc-b604-efea20829d93) — curated reading sets across workspaces
- [06 Tasks](/doc/0a55924e-39bf-4e84-ba9e-1abe68c0e0bf) — every markdown checkbox in one filterable list

### 04 Sharing

- [01 Public Share Links](/doc/4691db3e-cee1-45b0-bad8-997709083105) — read-only links anyone can open
- [02 Private Sharing by Email](/doc/2f9bcf96-ec27-400c-bd59-8d67391a8cf6) — named people, revocable *(Pro)*
- [03 Sharing Collections](/doc/669c61d4-1297-48e1-8e75-e82c10a2e60f) — folder structure or Knowledgebase mode
- [04 Comments](/doc/903dfdf8-7a29-4d3c-9282-1e595e474e49) — passage comments and moderation
- [05 What Readers See](/doc/cab68b8e-3ce1-48ea-a7e1-82c962bef030) — the experience from the other side of a link

### 05 Security and Privacy

- [01 Document Encryption](/doc/b230e154-6c58-4bfd-8a7a-c70bc7bebcd7) — AES-256 in your browser; the server never sees it
- [02 How MDflow Protects Your Data](/doc/6c08643f-a2c2-41e2-9b50-4616aa303476) — the privacy characteristics, and the limits
- [03 Deleting Your Account and Data](/doc/e74e57f7-89cc-4bfb-89ab-eb566a13c781) — permanent deletion, and what to export first

### 06 Import and Export

- [01 Importing Markdown](/doc/3f705ca5-b0f7-45ed-82c5-b309cab6c953) — drag in files or a whole folder tree
- [02 Exporting a Workspace](/doc/7666542c-b167-4475-9026-2fb85f335e19) — a self-contained `.zip` that renders offline

### 07 Integrations

- [01 GitHub](/doc/62a51527-90fe-45db-b5bb-1f25afa74d89) — edit repository markdown, commit straight back
- [02 Google Drive](/doc/60305bc2-761b-4896-837f-80022655df9f) — least-privilege access to files you pick
- [03 Custom Domain](/doc/a0c060cd-1a28-4b36-89ec-63c6763d31ce) — serve share links from your own domain *(Pro)*

### 08 Apps and Extensions

- [01 VS Code and Cursor Extension](/doc/3baa2c9f-85cb-446d-b20e-1054cefee7c5) — your workspace inside your editor *(Pro)*
- [02 iOS App](/doc/0a35e506-d632-4f07-aa6a-1d19a5ab3940) — iPhone and iPad, with Siri, widgets and Face ID
- [03 n8n Node](/doc/4fbc5f67-b6ac-4fed-8916-3ccfa4eb8632) — workflow automation *(Pro)*

#### Web Clipper

- [01 Overview and Installation](/doc/67e0b193-089d-4557-9fe8-7287f050e332) — save web pages as clean markdown
- [02 Connecting to MDflow](/doc/5c504c17-64be-489c-8830-4789fb3ceb75) — token setup and what the errors mean
- [03 Ways to Clip](/doc/16f31233-5d90-427d-acc7-bc9e2c1b7e9a) — popup, side panel, context menu, shortcuts
- [04 The Highlighter](/doc/466d2aba-91b7-4325-b55f-0cd310785c03) — mark up pages, clip only what you marked
- [05 Templates](/doc/0748c8b4-83f4-4af8-a81c-303c8dacfa71) — per-site formatting, chosen automatically
- [06 Variables and Filters](/doc/3bffaf4b-3def-4db6-8c53-df72d1066906) — pulling data out of a page
- [07 Properties](/doc/ed2210c4-8301-4474-b2e3-5af726a8d4c4) — typed frontmatter on your clips
- [08 AI Interpreter](/doc/4083577d-96da-4ee2-8e3b-1faee2410775) — natural-language extraction with your own model
- [09 Settings, History and Language](/doc/18e5ce0b-882b-41d3-9153-8ecfcf605e5f) — and what lives locally rather than in MDflow

### 09 API and AI Agents

- [01 Personal Access Tokens](/doc/bdefa552-e9b6-4382-a479-91615474cf69) — what a token grants, and what it cannot reach
- [02 HTTP API](/doc/bdb63d7f-857f-42ef-b13f-aa4d139e7cf8) — the versioned JSON API *(Pro)*
- [03 MCP Servers](/doc/aad78a27-0654-4781-b4b7-6ced0b14dbfc) — hosted and local, and how retrieval works *(Pro)*
- [04 Connecting Claude, ChatGPT and Other Clients](/doc/72aa97f1-fef9-4465-82fc-0a21ee327252) — OAuth, no token to paste
- [05 Agent Discovery Files](/doc/e6cc65f9-1e9a-484f-b1fa-e4eb22da894d) — `llms.txt`, `docs.md`, the agent card
- [06 mdflow-crypt CLI](/doc/805092df-0030-4567-ab01-3a4c7c06aff8) — encrypt and decrypt locally

### 10 Reference

- [01 Keyboard Shortcuts](/doc/4dad58cb-95b0-48f0-b8dd-2f6501c5f26f)
- [02 Limits and Quotas](/doc/64c23a82-faef-4071-9bb3-10ce83bf8faa) — every number in one place
- [03 Troubleshooting](/doc/ba04618a-7be0-4965-abe7-cfa9f686ce5c) — the errors people actually hit
- [04 Not Currently Supported](/doc/22f4f875-712d-45c0-b327-0c5fa1068773) — an honest list of what MDflow does not do

### Help

- [01 Support](/doc/b537e13c-ee9e-488d-a319-9c3d51db03d1) — the support form, email, and what to include

## Three things worth knowing early

**Folder descriptions are the retrieval signal.** When an AI agent asks MDflow for context, it ranks folder descriptions *above* folder names and document titles. A folder called `Notes` with no description is nearly invisible to an agent. See [02 Folders and Subfolders](/doc/ee296c64-ecda-49e9-a03f-1834eb1746d1).

**Anything using a Personal Access Token requires Pro** — the API, both MCP servers, the Web Clipper, the editor extension, the n8n node. The iOS app is the exception. See [01 Personal Access Tokens](/doc/bdefa552-e9b6-4382-a479-91615474cf69).

**There is no trash.** Deletions are immediate and permanent. Version history *(Pro)* can recover a document's body, but not a deleted document. See [03 Managing Documents](/doc/141dee01-12f7-4d36-b699-a642974fd4b5).