Working with Templates

Unmarkdown™ offers 62 templates across 8 categories. Each template controls typography, colors, spacing, and element styling. Apply a template by passing its template_id when creating or publishing a document.

Browse templates

List all available templates via the API:

curl https://api.unmarkdown.com/v1/templates \
  -H "Authorization: Bearer um_your_key_here"

const response = await fetch(
  "https://api.unmarkdown.com/v1/templates",
  {
    headers: { "Authorization": "Bearer um_your_key_here" },
  }
);

const { data, total } = await response.json();
console.log(`${total} templates available`);

import requests

response = requests.get(
    "https://api.unmarkdown.com/v1/templates",
    headers={"Authorization": "Bearer um_your_key_here"},
)

data = response.json()
print(f"{data['total']} templates available")

Filter by category

Use the category query parameter to filter templates:

curl "https://api.unmarkdown.com/v1/templates?category=developer" \
  -H "Authorization: Bearer um_your_key_here"

Available categories: free, business, academic, developer, creative, dark, productivity, special.

Template tiers

Free accounts can use any of the 8 free templates. Pro accounts unlock all 62.

Choosing the right template

Here are some recommendations based on content type:

Apply a template

Pass the template_id when creating or publishing a document:

curl -X POST https://api.unmarkdown.com/v1/documents/publish \
  -H "Authorization: Bearer um_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Report",
    "content": "# Q1 Report\n\n## Revenue\n\nRevenue grew 15% quarter over quarter.",
    "template_id": "annual-report",
    "theme_mode": "light"
  }'

Light and dark mode

Every template supports both light and dark mode. Set theme_mode to "light" or "dark":

{
  "content": "# My Document",
  "template_id": "dracula",
  "theme_mode": "dark"
}

If omitted, theme_mode defaults to "light".

Change a document's template

Update an existing document's template with a PATCH request:

curl -X PATCH https://api.unmarkdown.com/v1/documents/YOUR_DOC_ID \
  -H "Authorization: Bearer um_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"template_id": "tokyo-night", "theme_mode": "dark"}'

The change takes effect immediately on the published page.

Next steps

• Templates Catalog: Full list of all 62 templates with descriptions
• Rich Content: Add diagrams, charts, and math that render with your chosen template's colors
• API Reference: Templates: Templates endpoint documentation