# MDflow FAQ > Frequently asked questions about MDflow (https://mdflow.cz) — the online > markdown editor for writing, organizing, and sharing markdown with people and > AI agents. This is the plain-markdown twin of https://mdflow.cz/faq. Last > updated June 2026. ## Best markdown tools ### What is the best online markdown editor? The best online markdown editor is one that's instant to start, keeps your files as portable markdown, and shares cleanly with people and AI agents. MDflow runs a Monaco-powered editor in the browser — live preview, GitHub Flavored Markdown, folders, one-click sharing, and PDF export — plus a built-in HTTP API and MCP server for AI agents. Nothing to install, and the free plan needs no card. ### What is the best way to share markdown files online? The cleanest way to share markdown online is a rendered link, not a raw file. In MDflow, turn on sharing for any document to get an unguessable 64-character public URL that opens a formatted, mobile-friendly page — no account needed to read. You can allow comments, let readers clone their own copy, or instead share privately with specific people by email. ### Is there a free online markdown editor? Yes. MDflow has a free plan with no credit card: up to 5 markdown documents and 5 image uploads, plus public sharing links, reader comments, collections, and client-side encryption. You write in a Monaco editor with live preview and GitHub Flavored Markdown. Upgrading to Pro (€4.99/month) removes the limits and unlocks the API and MCP server. ### What is the best markdown editor for working with AI agents like ChatGPT and Claude? MDflow is built for AI agents. It exposes a remote Model Context Protocol (MCP) server and a full read/write HTTP API, so Claude, ChatGPT, Cursor, and Codex can create, read, update, organize, and share your markdown directly. It also publishes machine-readable discovery files — `llms.txt`, `docs.md`, and an agent card — so agents can find and operate the workspace on their own. ## Getting started with MDflow ### What is MDflow? MDflow is an online markdown workspace at https://mdflow.cz for writing, organizing, and sharing markdown documents in the browser. You keep content as portable plain-text markdown, organize it into folders and collections, share it as a clean public link or privately by email, and expose the same documents to scripts and AI agents through an HTTP API and an MCP server. ### Do I need to install anything to use MDflow? No. MDflow runs entirely in your web browser — there's no desktop app to install and no extension required to write or share. Sign in with Google, Apple, GitHub, or Microsoft and start writing. Optional companions exist (a web clipper extension and a downloadable local MCP server), but the core editor and sharing work from any modern browser. ### How do I create a markdown document in MDflow? Sign in, create a folder in the sidebar, then add a new document inside it and start typing markdown. The Monaco editor offers Edit, Split, and Preview views with a live rendered preview. Save with the button or `Cmd+S` (`Ctrl+S`), and an indicator shows unsaved changes. New accounts also start with a sample folder and a Readme to explore. ### Can I import my existing markdown files? Yes. Drag `.md` or `.markdown` files into the sidebar, or use the file picker, to import them as editable documents — several at once, into a chosen folder. MDflow preserves the markdown source and auto-renames duplicates. Imported files are limited to 500 KB each. Because everything stays plain markdown, there's no lock-in if you later want to move it elsewhere. ## Sharing markdown ### How do I share a markdown file? Open the document, turn on sharing, and copy the public link. Anyone with the link opens a clean rendered page — no MDflow account needed — and can switch between preview, source, and split views, download the `.md`, or export a PDF. You can enable comments, and turning sharing off permanently invalidates the old link. ### How do I share a markdown file with someone who doesn't have an account? Use a public link. In MDflow, enabling public sharing generates an unguessable 64-character URL that renders the document as a clean page for anyone — no sign-in or account required to read it. The rest of your workspace stays private, and your name and email are never shown on the shared page. ### How do I share a markdown file privately with specific people? On Pro, use private sharing by email. Add a person's email and choose their access — view only, or view and comment. They open a private link, sign in with that email, and see the document under "Shared with me." No public link is created, and you can revoke any person's access, or everyone's, instantly. ### How do I share several markdown documents together as one set? Use a collection. Group related documents — or whole folders — into a named collection, then share it with one link. Readers get a clean reader with a file list and the same preview, source, split, download, and PDF options as a single shared document. Collections can be public or shared privately by email, and a document can belong to several collections at once. ### Can people comment on a markdown document I share? Yes. Enable commenting on a shared document and signed-in readers can attach comments to specific passages, which are highlighted in the source view. You moderate everything from your normal editor and can delete any comment. Comments are preserved if you temporarily turn sharing off, and reappear when you re-enable it. ### How do I get a public link or raw markdown URL for a document? Turn on public sharing to get the rendered link. For the raw source, append `.md` to any share URL — for example `https://mdflow.cz/share/.md` — and MDflow returns plain markdown with YAML frontmatter (title, canonical URL, visibility) and open CORS. That raw `.md` twin lets tools and AI agents fetch and cite a document in a single request. ## Markdown for AI agents ### How do I share markdown with Claude or ChatGPT? Two ways. For a one-off, share a document publicly and paste its link — or its raw `.md` URL — into the chat. For ongoing access, connect MDflow's MCP server or HTTP API with a Personal Access Token so Claude, ChatGPT, Cursor, or Codex can read and write your whole workspace directly. Agent access is a Pro feature. ### What is the MDflow MCP server and how do I connect it? MDflow's MCP server lets Model Context Protocol clients operate your workspace. The hosted remote server is at `https://mdflow.cz/api/mcp` over Streamable HTTP, authenticated with a Bearer Personal Access Token; a downloadable local stdio server is also available. It works with Claude Code, Claude Desktop, Cursor, Codex, and the OpenAI Responses API. Full setup is at https://mdflow.cz/docs/mcp. Requires Pro. ### Does MDflow have an API for markdown? Yes — a versioned JSON HTTP API at `/api/v1`, authenticated with a Bearer Personal Access Token. It lists, fetches, creates, updates, moves, and deletes documents and folders, and manages public and private sharing. There's an OpenAPI 3.1 spec at `https://mdflow.cz/openapi.json` and human docs at https://mdflow.cz/docs/api. The rate limit is 30 requests per minute. The API requires Pro. ### How can an AI agent read and write my markdown documents? Give the agent a Personal Access Token, then point it at the MCP server or the HTTP API. Both grant scoped read/write access to your workspace: list folders and documents, fetch a document's body, create and update documents, move and delete them, and manage sharing. Agents can also request the most relevant documents for a topic, ranked by folder descriptions. ### How do AI agents discover an MDflow workspace? MDflow publishes machine-readable discovery files. `llms.txt` indexes the docs, pricing, API, and MCP server; `docs.md` is a self-contained agent control manual; `pricing.md` exposes plan limits; and `/.well-known/agent-card.json` is an A2A discovery card describing interfaces, auth, and skills. Any shared page also has a raw `.md` twin, so agents can read and cite documents directly. ### Can I capture web pages as markdown for my AI workflow? Yes, with the MDflow Web Clipper. The extension — Chrome, Brave, Arc, Edge, Firefox, and Safari — saves any web page into your workspace as clean markdown, stripping ads and navigation. Clip a full article, a selection, or saved highlights, with templates and an optional AI interpreter. Clipped pages land in MDflow, ready to share or feed to an agent. ## Editor & markdown format ### What markdown syntax does MDflow support? MDflow supports GitHub Flavored Markdown (GFM): headings, bold and italic, links, ordered and unordered lists, task lists, blockquotes, fenced code blocks, tables, strikethrough, horizontal rules, and images. A built-in help panel shows practical examples, and the live preview renders exactly what your readers will see. Images can be uploaded files or external URLs. ### Can I add images to a markdown document? Yes. In the desktop editor, drag an image in or paste from the clipboard and MDflow inserts the markdown image syntax and uploads the file. It supports JPEG, PNG, and WebP up to 20 MB, resizing to a max 1024 px in the browser before upload. Uploaded images stay private unless the saved public document references them. Markdown can also embed external image URLs. ### Can I export markdown to PDF? Yes. Any document — yours or one shared with you — can be exported to PDF through a print-ready flow that renders the formatted markdown. You can also download the original source as a `.md` file at any time. Both options are available in the editor and in the reader view for shared documents. ### Does MDflow work on mobile? Yes. MDflow is fully responsive, with a collapsible drawer and mobile-friendly editing and preview, and split view simplifies to a single pane on narrow screens. Readers can view shared documents and images on any device. Image uploading is currently desktop-only, but mobile readers can still see uploaded images. ### Will my markdown stay portable, or am I locked in? Your content stays portable. MDflow stores documents as plain-text markdown, not a proprietary format, and you can download any document as a `.md` file or fetch it via the API or raw `.md` URL whenever you want. There's no export tax and no lock-in — the format you write in is the format you keep. ## Security, privacy & pricing ### Is my markdown private and secure? Yes. Workspace routes require authentication and every read and write is checked against ownership server-side. Public links use random 64-character slugs and expose only the shared document, never your identity, email, or other content; disabling a link invalidates it permanently. API access is scoped to the token owner and tokens can be revoked instantly. ### Can I password-protect or encrypt a markdown document? Yes. MDflow can encrypt any document with a password using AES-256-GCM, entirely in your browser. The server only ever stores ciphertext — it never sees the contents or the password. Encrypted documents are excluded from search, and a shared encrypted document shows a password gate to readers. If you lose the password the document can't be recovered, so save it safely. ### How much does MDflow cost? Is it free? MDflow has a free plan — 5 documents and 5 images, with public sharing, comments, collections, and encryption included at no cost. Pro is €4.99/month with a 7-day free trial and removes the limits: unlimited documents, a large image allowance, private email sharing, Personal Access Tokens, the HTTP API, and the remote MCP server. Cancel anytime. ### How does MDflow compare to Notion, Google Docs, and Obsidian for markdown? Notion and Google Docs store content in proprietary formats and only export markdown approximately; MDflow is markdown-native, so what you write is what you keep. Obsidian is markdown too, but it's local-first and leans on plugins and paid sync for sharing and AI access. MDflow is browser-based with free sync, clean reader sharing, and a built-in API and MCP server. ### How do I get started with MDflow? Go to https://mdflow.cz and sign in with Google, Apple, GitHub, or Microsoft — the free plan needs no credit card. Create a folder, add a document, and start writing markdown. Share it with a public link or by email when you're ready, and connect the API or MCP server if you want AI agents to use it. Upgrade to Pro anytime to remove limits. --- See also: https://mdflow.cz/faq · https://mdflow.cz/docs.md · https://mdflow.cz/pricing.md · https://mdflow.cz/llms.txt · https://mdflow.cz/openapi.json