Mdfy
MCP server for mdfy.app β let AI tools create and manage Markdown documents
Ask AI about Mdfy
Powered by Claude Β· Grounded in docs
I know everything about Mdfy. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
mdcore
The fastest way from thought to shared document.
Markdown URLs that humans write and AI reads. Import anything. Render beautifully. Share instantly. Powered by Rust + WASM.
mdcore engine (Rust)
β
ββββββββββββββββΌβββββββββββββββ
β β β
WASM napi-rs native
β β β
ββββββΌβββββ ββββββΌβββββ βββββΌβββββ
Browser Edge Deno Node Raycast CLI Mobile
mdfy.app CF npm Obsidian brew iOS
Workers pkg VS Code install Android
What is this?
mdcore is a Markdown parsing, rendering, and conversion engine built in Rust. mdfy.app is the full document platform built on top of it.
Every document gets a permanent short URL (mdfy.app/abc123) that works everywhere β browsers, AI chats, Slack, email, embeds. No login to view. No paywall.
8 Channels
mdfy.app is available everywhere:
| Channel | Status | Install |
|---|---|---|
| Web | Live | Just open mdfy.app |
| VS Code | v1.3.0 | Marketplace or .vsix download |
| Desktop (Mac) | v2.0.0 | DMG download |
| CLI | v1.3.0 | npm install -g mdfy |
| MCP Server | v1.3.0 | npx mdfy-mcp or hosted mdfy.app/api/mcp |
| Chrome Extension | v2.0.0 | Download from releases |
| QuickLook (Mac) | v1.0.0 | Download |
| API | Live | https://mdfy.app/api/docs |
Features
Editor
- WYSIWYG β edit directly in the rendered preview (contentEditable)
- Source β CodeMirror 6 with Markdown syntax highlighting
- Split view β side-by-side Live + Source panels
- Floating toolbar β context-aware formatting on text selection
- Cmd+Enter β escape from blockquote/list/code blocks
- Mermaid visual editor β drag-and-drop flowchart canvas
Import (13+ formats)
- Documents β MD, PDF, DOCX, PPTX, XLSX, HTML, RTF
- Data β CSV, JSON, XML
- Academic β LaTeX, reStructuredText
- AI output β auto-detects ChatGPT/Claude/Gemini conversations
- CLI output β auto-detects terminal tables and unicode formatting
Export
- Download β Markdown, HTML, Plain Text
- Print β PDF via browser print (custom print CSS)
- Clipboard β Raw HTML, Rich Text (Google Docs/Email), Slack mrkdwn
- Share β Short URL, QR Code, Embed code (iframe)
Rendering
- Full GFM β tables, task lists, footnotes, strikethrough, autolinks
- Math β KaTeX inline (
$...$) and display ($$...$$) - Mermaid β flowcharts, sequence, gantt, class, state diagrams
- 190+ languages β syntax highlighting via highlight.js
- ASCII diagrams β auto-detect and style box-drawing characters
- Flavor detection β auto-detects GFM, Obsidian, MDX, Pandoc, CommonMark
Organization
- Folders with drag-and-drop
- Trash with restore
- Sort by newest, oldest, AβZ, ZβA
- Document search
- Simple / Detailed sidebar modes
Sharing & Access
- Owner-only editing model (non-owners view, duplicate to edit)
- Password protection + expiry dates
- Email allowlist for restricted access
- View count tracking
- Key color + skin theme customization (8 colors, 8 schemes)
Auth
- Google / GitHub OAuth + Email magic link
- Anonymous editing (no login required to create)
- Cloud sync across devices
CLI
# Publish a file
mdfy publish README.md
# Pipe from any command
echo "# Hello" | mdfy publish
tmux capture-pane -p | mdfy publish
pbpaste | mdfy publish
# Manage documents
mdfy list
mdfy read abc123
mdfy update abc123 updated.md
mdfy search "meeting notes"
mdfy pull abc123 -o doc.md
MCP Server
Connect any AI tool to mdfy.app:
{
"mcpServers": {
"mdfy": {
"command": "npx",
"args": ["mdfy-mcp"]
}
}
}
Or use the hosted endpoint: https://mdfy.app/api/mcp
25 tools: create, read, update, delete, list, search, append, prepend, sections, sharing, versions, folders, stats, and more.
Packages
| Package | Description | Install |
|---|---|---|
@mdcore/engine | Rust WASM engine + TypeScript postprocessor | npm i @mdcore/engine |
@mdcore/styles | CSS-only rendering styles (dark/light themes) | npm i @mdcore/styles |
@mdcore/api | HTTP client for mdfy.app API | npm i @mdcore/api |
@mdcore/ai | AI provider abstraction (Gemini, OpenAI, Anthropic) | npm i @mdcore/ai |
Tech Stack
| Layer | Technology |
|---|---|
| Core Engine | Rust + comrak |
| WASM | wasm-bindgen + wasm-pack |
| Web App | Next.js 15 + React 19 + TailwindCSS v4 |
| Desktop | Electron |
| VS Code | Extension API + WebView |
| Source Editor | CodeMirror 6 |
| Math | KaTeX |
| Diagrams | Mermaid.js |
| Auth | Supabase Auth |
| Database | Supabase PostgreSQL |
| Realtime | Supabase Realtime (Yjs CRDT) |
| Hosting | Vercel |
Quick Start
# Run the web app
cd apps/web
npm install
npm run dev # β http://localhost:3000
# Build the Rust engine
cd packages/engine
cargo test
wasm-pack build --target bundler --out-dir ../../apps/web/src/lib/wasm --release
# Build Desktop DMG
cd apps/desktop
npm run build:dmg
Project Structure
mdcore/
βββ packages/
β βββ engine/ # Rust core (comrak β WASM)
β βββ mdcore/ # @mdcore/engine npm package
β βββ styles/ # @mdcore/styles (CSS-only)
β βββ api/ # @mdcore/api (HTTP client)
β βββ ai/ # @mdcore/ai (AI providers)
βββ apps/
β βββ web/ # Next.js 15 (mdfy.app)
β βββ desktop/ # Electron Mac app
β βββ vscode-extension/ # VS Code extension
β βββ chrome-extension/ # Chrome extension
β βββ quicklook/ # macOS QuickLook
βββ docs/ # Architecture, roadmap, manifesto
βββ .github/workflows/ # CI/CD
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| βB | Bold |
| βI | Italic |
| βK | Insert link |
| βS | Share / copy URL |
| ββ§C | Copy HTML |
| βZ / ββ§Z | Undo / Redo |
| β\ | Toggle view mode |
| βEnter | Exit block (quote/list/code) |
| βK | Command palette |
| Alt+1/2/3 | Live / Split / Source |
| Dbl-click | Edit code/math/diagram/table |
Roadmap
- Rust WASM engine + Next.js web app
- WYSIWYG + Source + Split editing
- 13+ format import (PDF, DOCX, PPTX, XLSX...)
- Math (KaTeX), Mermaid diagrams, 190+ language highlighting
- Short URL sharing + QR code + embed
- Auth (Google/GitHub/Email) + cloud sync
- Password protection + expiry + email allowlist
- Folders + Trash + sorting
- VS Code extension (Marketplace)
- Desktop Mac app (Electron)
- Chrome extension (ChatGPT/Claude/Gemini capture)
- CLI tool (
npm install -g mdfy) - MCP Server (25 tools, hosted + stdio)
- macOS QuickLook
- REST API + documentation
- Mermaid visual editor (canvas)
- AI conversation detection + formatting
- Key color + skin theme customization
- Owner-only editing model
- Document notifications
- Stripe billing (Pro tier)
- Custom domains
- View analytics dashboard
- Obsidian plugin
- Mobile (iOS/Android)
License
MIT
mdcore β The fastest way from thought to shared document.
