---
title: "Convert markdown to destination-specific output"
method: POST
path: "/convert"
---

# Convert markdown to destination-specific output

`POST /convert`

## Request

- Base URL: `https://api.unmarkdown.com/v1`
- URL: `https://api.unmarkdown.com/v1/convert`
- Auth: HTTP bearer

Converts markdown to HTML optimized for a specific destination (Google Docs, Word, Slack, OneNote, Email, or plain text). Does not save the document. Use this when you need formatted output for pasting into other applications.

## Request body

- ConvertRequest
  - `markdown` string, required: Markdown content to convert (max 100KB)
  - `destination` 'google-docs' | 'email' | 'word' | 'slack' | 'onenote' | 'plain-text' | 'generic' | 'html': Target format for the conversion output
  - `template_id` string: Template ID to apply for styling
  - `theme_mode` 'light' | 'dark'

## Response `200`

Conversion successful

- ConvertResponse
  - `html` string
  - `plain_text` string
  - `destination` string
  - `template_id` string
  - `theme_mode` string

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `429`: Rate limit or quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/unmarkdown/apis/unmarkdown-api.md) · [All operations](https://skmtc.dev/unmarkdown/apis/unmarkdown-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unmarkdown/apis/unmarkdown-api/revisions/9eb23eef75d6?raw)