Markdown to PDF
v2 public betaREST API

用途に合った洗練された文書を作る Markdown PDF API と MCP

版管理された Markdown 文書を作成し、洗練された PDF を非同期で公開して、権限を限定した REST API から検証済み成果物をダウンロードできます。

premium 体験

POST/api/v2/documents
{
  "taskId": "consulting-proposal",
  "revision": {
    "markdown": "# Northstar Proposal...",
    "spec": { "templateId": "proposal-consulting" }
  }
}
Executive template API request and PDF preview
verified artifactSHA-256

クイックスタート

文書を作成・公開し、検証済み PDF をダウンロードします。

cURL
#!/usr/bin/env bash
set -euo pipefail

API="https://markdowntopdfconverter.com"
RUN_ID="proposal-$(date +%s)"
AUTH="Authorization: Bearer $MD2PDF_API_KEY"

DOCUMENT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/documents" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RUN_ID-document" \
  --data '{"taskId":"consulting-proposal","title":"Northstar proposal","revision":{"markdown":"# Northstar Proposal\n\n## Outcome\nA decision-ready roadmap.","parentRevisionId":null,"spec":{"locale":"en","options":{"pageNumbers":true},"templateId":"proposal-consulting"}}}')

DOCUMENT_ID=$(jq -r '.document.id' <<<"$DOCUMENT")
REVISION_ID=$(jq -r '.revision.id' <<<"$DOCUMENT")
JOB=$(curl --fail --silent --show-error --max-time 30 \
  "$API/api/v2/documents/$DOCUMENT_ID/publishes" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RUN_ID-publish" \
  --data "{"revisionId":"$REVISION_ID","output":{"format":"pdf","filename":"northstar-proposal.pdf"}}")
JOB_ID=$(jq -r '.job.id' <<<"$JOB")

for ATTEMPT in $(seq 1 100); do
  RESULT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/jobs/$JOB_ID" -H "$AUTH")
  STATUS=$(jq -r '.job.status' <<<"$RESULT")
  [[ "$STATUS" == "succeeded" ]] && break
  [[ "$STATUS" == "failed" || "$STATUS" == "cancelled" ]] && exit 1
  sleep 3
done
[[ "$STATUS" == "succeeded" ]] || { echo "Timed out waiting for PDF" >&2; exit 1; }

ARTIFACT_ID=$(jq -r '.artifact.id' <<<"$RESULT")
LINK=$(curl --fail --silent --show-error --max-time 30 -X POST \
  "$API/api/v2/artifacts/$ARTIFACT_ID/links" -H "$AUTH")
HREF=$(jq -r '.href' <<<"$LINK")
[[ "$HREF" == https://* ]] || { echo "Refusing non-HTTPS artifact URL" >&2; exit 1; }
curl --fail --location --proto '=https' --max-redirs 5 --max-time 60 "$HREF" \
  --output northstar-proposal.pdf
Verified PDFsucceeded
Polished consulting proposal PDF returned by the publishing API
Artifact
SHA-256
Download
private link

検証済みの自動化から開始

公開、ポーリング、非公開ダウンロードの全フローをインポートします。

n8n

永続待機と終了時エラー処理を備えた無効状態のワークフローです。

ワークフローをダウンロード

Make

認証情報を含まず、回数制限付きポーリングと重複防止を備えた Blueprint です。

Blueprint をダウンロード

Zapier

SDK Code ステップとガイド付きテンプレート定義をまとめたキットです。

セットアップキットをダウンロード

documents.render と documents.read の専用キーを使用します。署名付き URL はそのキーを付けずにダウンロードしてください。


Claude Code や AI エージェントから高品質な PDF テンプレートを利用

リモート MCP サーバーを一度接続すれば、会話を離れずに文書に最適な用途別テンプレートの提案や Markdown から高品質な PDF の生成をエージェントに依頼できます。

.mcp.json
{
  "mcpServers": {
    "markdown-to-pdf": {
      "type": "http",
      "url": "https://markdowntopdfconverter.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MD2PDF_API_KEY}"
      }
    }
  }
}

MCP は REST API と同じ API キーと利用枠を使用します。生成結果は15分で期限切れになる非公開リンクです。無料アカウントではアップグレード前にプレミアム出力を 5 回試せます。

API キーを作成

認証

Authorization ヘッダーに Bearer トークンとして送信するシークレット API キーで、すべてのリクエストを認証します。

リクエストヘッダー

ヘッダー説明
AuthorizationBearer mp_live_...Bearer を接頭した API キー
Content-Typeapplication/jsonすべてのリクエストに必須

一つの管理された公開ライフサイクル

再試行と監査を予測可能にするため、ソース、不変リビジョン、ジョブ、検証済み成果物を分離します。

  1. 01

    管理文書と最初のリビジョンを作成します。

  2. 02

    安定した冪等性キーで最終 PDF を要求します。

  3. 03

    succeeded、failed、cancelled のいずれかまで確認します。

  4. 04

    有効期間の短い非公開成果物リンクを発行します。

  5. 05

    Authorization を転送せず署名付き URL を取得します。


POST /api/v1/convert

Markdown をスタイルされた PDF ドキュメントに変換します。


テンプレート

9 種類の用途別ファミリーから 57 個のプロ向けテンプレートを選べます。ファミリーを開くと ID をコピーできます。

エグゼクティブ PDFレポート・企画書事業報告書、提案書、ビジュアルブリーフ向け。2 IDs
モダン・エディトリアル PDF履歴書第一印象を高める、明快で洗練された形式。10 IDs
モダン・レターヘッド PDFカバーレター履歴書と調和する応募書類向けレイアウト。10 IDs
高校論述課題 PDF課題高校・カレッジ・大学の課題を端正に仕上げる形式。9 IDs
コンサルティング提案書 PDF提案書受注、承認、提携、資金調達につながる提案書。9 IDs
製品ワンページ PDF営業・マーケティング販売、実績提示、発表に使える洗練された資料。9 IDs
完成論文 PDF学術文書出版、査読、学会発表に対応する形式。3 IDs
クリーン PDF書籍・長文ガイド、マニュアル、論考、書籍向けの読みやすい組版。4 IDs
法務 PDF法務文書契約書や合意書を整理された形式で作成。1 IDs

エラーコード

v2 の各エラーには、安定したコード、HTTP ステータス、retryable フラグ、任意の再試行待機時間が含まれます。retryable が true の場合にのみ再試行してください。

400 / 415 / 422invalid_request

retryable: false

401unauthorized

retryable: false

402quota_exhausted

retryable: false

403forbidden

retryable: false

404not_found

retryable: false

409idempotency_conflict

retryable: false

409invalid_state_transition

retryable: false

410artifact_expired

retryable: false

429rate_limited

retryable: true

503service_unavailable

retryable: true


API 料金

API コールは月次でトラックされます。各成功した変換は、お客様のティアの月次制限にカウントされます。

Free

CA$0

25 / month

Starter

CA$13.91 / month

500 / month

Pro

CA$82.14 / year

1,000 / month

Credits

CA$6.96 one-time

250 calls

もっと必要ですか?カスタム企業料金についてお問い合わせください。

premium PDF サンプルを生成し、API を組み込む価値があるか判断しましょう。

premium サンプルを試す