md.page API

Overview

md.page turns Markdown into shareable web pages. Two modes:

• Anonymous — no auth, pages expire in 24h.
• Authenticated — permanent pages at username.md.page/doc-name.

Base URL

https://md.page

Authentication

Authenticated endpoints need a Bearer token:

Authorization: Bearer mdp_your_api_key_here

Create keys in Settings. Keys start with mdp_ and are shown once.

Anonymous endpoints (POST /api/publish) need no auth.

---

Publish anonymous page

Temporary page, expires in 24h. No auth required.

Request body

Field	Type	Required	Description
markdown	string	Yes	Markdown content (max 500KB)

Example

curl -X POST https://md.page/api/publish \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello World\n\nThis is my page."}'

Response 201

{
  "url": "https://md.page/a8Xk2m",
  "expires_at": "2026-04-20T12:00:00.000Z"
}

---

Create page

Permanent page on your subdomain. Requires auth.

Request body

Field	Type	Required	Description
markdown	string	Yes	Markdown content (max 500KB)
title	string	No	Page title. Auto-extracted from # heading if omitted.
slug	string	No	URL name, e.g. my-doc. Auto-generated from title if omitted.
visibility	string	No	"public" (default) or "private"

Example

curl -X POST https://md.page/api/pages \
  -H "Authorization: Bearer mdp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# My Doc", "slug": "my-doc"}'

Response 201

{
  "id": "kR4x9p",
  "url": "https://alice.md.page/my-doc",
  "slug": "my-doc",
  "visibility": "public"
}

List pages

Response 200

{
  "pages": [
    {
      "id": "kR4x9p",
      "slug": "my-doc",
      "title": "My Doc",
      "visibility": "public",
      "view_count": 42,
      "revision_count": 3,
      "created_via": "api:claude-code",
      "created_at": "2026-04-19T10:00:00.000Z",
      "updated_at": "2026-04-19T12:00:00.000Z"
    }
  ]
}

Update page

All fields optional — send only what changed.

Request body

Field	Type	Description
markdown	string	New content
title	string	New title
slug	string	New URL name (must be unique)
visibility	string	"public" or "private"

Example

curl -X PUT https://md.page/api/pages/kR4x9p \
  -H "Authorization: Bearer mdp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Updated content"}'

Response 200

{"ok": true}

Delete page

Example

curl -X DELETE https://md.page/api/pages/kR4x9p \
  -H "Authorization: Bearer mdp_your_key"

Response 200

{"ok": true}

Current user

Response 200

{
  "id": "abc123",
  "username": "alice",
  "display_name": "Alice Chen",
  "avatar_url": "https://..."
}

---

Create API key

Request body

Field	Type	Required	Description
label	string	No	Name for this key, e.g. "claude-code"

Response 201

{
  "id": "uuid",
  "key": "mdp_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345",
  "label": "claude-code"
}

The key is shown once. Store it securely.

List keys

Response 200

{
  "keys": [
    {
      "id": "uuid",
      "label": "claude-code",
      "last_used_at": "2026-04-19T12:00:00.000Z",
      "created_at": "2026-04-18T10:00:00.000Z"
    }
  ]
}

Rename key

Request body

{"label": "new-name"}

Response 200

{"ok": true}

Revoke key

Response 200

{"ok": true}

---

Limits

Resource	Limit
Pages per account	10
API keys per account	5
Content size	500 KB
Anonymous TTL	24 hours

Errors

All errors return JSON with an error field:

{"error": "Missing 'markdown' field"}

Status	Meaning
400	Bad request — missing or invalid fields
401	Unauthorized — missing or invalid key
404	Not found
409	Conflict — name already taken
413	Content too large (>500KB)