Build a callout / admonition API

Overview

Generate a callout block in the exact syntax your target tool expects. Avoids the headache of remembering whether MkDocs uses `!!!`, Docusaurus uses `:::`, or GitHub uses `> [!NOTE]`.

Request

Authenticate with Authorization: Bearer YOUR_API_KEY and send a JSON body containing the parameters below. Pick your language:

curl -X POST 'https://trymarkdownviewer.com/api/v1/transform/callout' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"style":"github","kind":"note","title":"Heads up","body":"Read this."}'

Body parameters

Response

Success responses are wrapped in a data field. Errors use { error: { code, message } } with an appropriate HTTP status — see the error reference.

{
  "data": {
    "markdown": "> [!NOTE]\n> **Heads up**\n>\n> Read this.\n"
  }
}

Related endpoints

• POST

  /api/v1/render

  Render markdown

  Convert markdown into safe, sanitised HTML.

Free tools that run the same logic locally — no API key, no upload.

• Callout & Admonition Generator

  GitHub · Docusaurus · MkDocs