Developer Docs

Documentation

The publishing API for developers. Create, manage, and share Markdown documents programmatically.

Base URL: https://mdfy.app

Terminal
# Create a document$ curl -X POST https://mdfy.app/api/docs \ -H 'Content-Type: application/json' \ -d '{"markdown": "# Hello World"}'{ "id": "abc123", "url": "https://mdfy.app/abc123", "editToken": "eyJ..."}

Quick Start

curl

REST API

Create, read, update, and delete documents with HTTP requests.

View docs →
terminal

CLI

Publish from the command line. Pipe stdin, capture tmux panes.

View docs →
JS

JavaScript SDK

TypeScript-first client. MdfyClient class and standalone functions.

View docs →
MCP

MCP Server

Hosted HTTP endpoint for Claude Web + npm package for Claude Desktop, Cursor, Windsurf.

View docs →

Try It

Publish your first document in under 30 seconds. No authentication required.

bash
curl -X POST https://mdfy.app/api/docs \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello World\nPublished via API.", "isDraft": false}'

# Response:
# { "id": "abc123", "editToken": "tok_...", "created_at": "..." }
# View at: https://mdfy.app/abc123

Explore

Publish from AI

Claude (MCP), ChatGPT (Custom GPT), Chrome Extension. Say "publish this" in any AI.

Integrations

VS Code, Mac Desktop, Chrome Extension, CLI, MCP Server, QuickLook, tmux — 8 channels.

Authentication

Edit tokens, user identity headers, OAuth bearer tokens.

npm Packages

@mdcore/api, engine, styles, ai. Independent packages.

For AI consumption, see /docs/llms.txt