About Mdfy
Mdfy is an MCP server in the AI category: mCP server for mdfy.app — let AI tools create and manage Markdown documents.
Install
claude mcp add mdfy -- npx -y mdfy-mcpnpx -y mdfy-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Mdfy
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.