Build with Unmarkdown

Publish beautiful documents from your app, AI agent, or workflow. One API call turns markdown into a styled, hosted web page.

View OpenAPI Spec

Quick Start

Create and publish a document in a single API call. Get back a live URL.

curl -X POST https://api.unmarkdown.com/v1/documents/publish \
  -H "Authorization: Bearer um_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Weekly Report",
    "content": "# Weekly Report\n\n## Highlights\n\n- Shipped v2.0...",
    "template_id": "executive"
  }'

Response

{
  "id": "a1b2c3d4-...",
  "title": "Weekly Report",
  "published_url": "https://unmarkdown.com/u/yourname/weekly-report",
  "published_at": "2026-02-14T12:00:00.000Z",
  "template_id": "executive",
  "word_count": 450,
  "reading_time_minutes": 3
}

What You Can Publish

Standard markdown syntax powers all of these. No custom markup needed.

Mermaid Diagrams

12 types: flowchart, sequence, class, state, ER, pie, gantt, journey, mindmap, timeline, quadrant, git graph

```mermaid
graph TD
  A --> B --> C
```

Chart.js Charts

8 types: bar, line, pie, doughnut, radar, polar area, scatter, mixed

```chart
{"type":"bar","data":{...}}
```

Graphviz Graphs

8 engines: dot, neato, twopi, circo, fdp, sfdp, osage, patchwork

```dot
digraph { A -> B -> C }
```

KaTeX Math

Inline and display math with full LaTeX support

$E = mc^2$ and $$\int_0^\infty$$

Callouts

5 GitHub-compatible types: NOTE, TIP, IMPORTANT, WARNING, CAUTION

> [!NOTE]
> Important info here

62 Templates

8 categories: Free, Business, Academic, Developer, Creative, Dark, Productivity, Special

"template_id": "executive"

Endpoint Reference

Base URL: https://api.unmarkdown.com/v1

Convert

POST/v1/convertConvert markdown to destination-specific HTML

Documents

POST/v1/documentsCreate a new document

GET/v1/documentsList your documents

GET/v1/documents/:idGet a document with full content

PATCH/v1/documents/:idUpdate a document

DELETE/v1/documents/:idDelete a document

Publish

POST/v1/documents/:id/publishPublish an existing document

DELETE/v1/documents/:id/publishUnpublish a document

POST/v1/documents/publishCreate and publish in one call

Demo

POST/v1/demo/publishPublish without authentication (72h expiry)

POST/v1/demo/claimClaim a demo document to your account

Templates

GET/v1/templatesList all 62 available templates

Usage

GET/v1/usageCheck your API usage and quota

Authentication and Limits

API Keys

Create keys in Settings, API tab
Keys start with the um_ prefix
Up to 2 active keys per account
Send via Authorization: Bearer um_...

Rate Limits

Tier	Requests/sec	Calls/month
Free	10	1,000
Pro	30	10,000

Demo Publish

Publish a page without creating an account. No authentication needed. Pages expire after 72 hours. Use the claim token to save a demo permanently to your account.

# No authentication required
curl -X POST https://api.unmarkdown.com/v1/demo/publish \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quick Demo",
    "content": "# Hello World\n\nPublished via the API.",
    "template_id": "github"
  }'

# Response includes a claim_token to save it permanently
# {
#   "url": "https://unmarkdown.com/p/abc123",
#   "claim_token": "550e8400-e29b-..."
# }

Free Templates

8 templates available on the free tier. Use the template_id in any API call. Browse all 62 templates

Swiss

Clean, modern (default)

swiss

Mono

Monospace minimal

mono

Paper

Classic paper-like

paper

Ink

Bold ink-inspired

ink

GitHub

GitHub README style

github

Newsletter

Email newsletter

newsletter

Terminal

Console aesthetic

terminal

Notion-esque

Notion-inspired

notion

Resources

OpenAPI Spec

Machine-readable API schema for code generation and tooling

llms.txt

LLM-optimized product and API summary

Full LLM Docs

Complete API reference with examples for LLM consumption

Integrations

MCP Server + AI Integrations

GPT Action (coming soon)

TypeScript SDK (coming soon)