用途に合った洗練された文書を作る Markdown PDF API と MCP
版管理された Markdown 文書を作成し、洗練された PDF を非同期で公開して、権限を限定した REST API から検証済み成果物をダウンロードできます。
premium 体験
/api/v2/documents{
"taskId": "consulting-proposal",
"revision": {
"markdown": "# Northstar Proposal...",
"spec": { "templateId": "proposal-consulting" }
}
}
SHA-256POST /api/v2/documents → /publishes
クイックスタート
文書を作成・公開し、検証済み PDF をダウンロードします。
#!/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
- Artifact
- SHA-256
- Download
- private link
検証済みの自動化から開始
公開、ポーリング、非公開ダウンロードの全フローをインポートします。
n8n
永続待機と終了時エラー処理を備えた無効状態のワークフローです。
Make
認証情報を含まず、回数制限付きポーリングと重複防止を備えた Blueprint です。
Zapier
SDK Code ステップとガイド付きテンプレート定義をまとめたキットです。
documents.render と documents.read の専用キーを使用します。署名付き URL はそのキーを付けずにダウンロードしてください。
Claude Code や AI エージェントから高品質な PDF テンプレートを利用
リモート MCP サーバーを一度接続すれば、会話を離れずに文書に最適な用途別テンプレートの提案や Markdown から高品質な PDF の生成をエージェントに依頼できます。
{
"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 キーで、すべてのリクエストを認証します。
リクエストヘッダー
| ヘッダー | 値 | 説明 |
|---|---|---|
| Authorization | Bearer mp_live_... | Bearer を接頭した API キー |
| Content-Type | application/json | すべてのリクエストに必須 |
一つの管理された公開ライフサイクル
再試行と監査を予測可能にするため、ソース、不変リビジョン、ジョブ、検証済み成果物を分離します。
- 01
管理文書と最初のリビジョンを作成します。
- 02
安定した冪等性キーで最終 PDF を要求します。
- 03
succeeded、failed、cancelled のいずれかまで確認します。
- 04
有効期間の短い非公開成果物リンクを発行します。
- 05
Authorization を転送せず署名付き URL を取得します。
POST /api/v1/convert
Markdown をスタイルされた PDF ドキュメントに変換します。
テンプレート
9 種類の用途別ファミリーから 57 個のプロ向けテンプレートを選べます。ファミリーを開くと ID をコピーできます。
履歴書第一印象を高める、明快で洗練された形式。10 IDs
カバーレター履歴書と調和する応募書類向けレイアウト。10 IDs
課題高校・カレッジ・大学の課題を端正に仕上げる形式。9 IDs
提案書受注、承認、提携、資金調達につながる提案書。9 IDs
営業・マーケティング販売、実績提示、発表に使える洗練された資料。9 IDs
学術文書出版、査読、学会発表に対応する形式。3 IDs
書籍・長文ガイド、マニュアル、論考、書籍向けの読みやすい組版。4 IDs
法務文書契約書や合意書を整理された形式で作成。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
| ステータス | code | retryable |
|---|---|---|
| 400 / 415 / 422 | invalid_request | false |
| 401 | unauthorized | false |
| 402 | quota_exhausted | false |
| 403 | forbidden | false |
| 404 | not_found | false |
| 409 | idempotency_conflict | false |
| 409 | invalid_state_transition | false |
| 410 | artifact_expired | false |
| 429 | rate_limited | true |
| 503 | service_unavailable | true |
API 料金
API コールは月次でトラックされます。各成功した変換は、お客様のティアの月次制限にカウントされます。
CA$0
25 / month
CA$13.91 / month
500 / month
CA$82.14 / year
1,000 / month
CA$6.96 one-time
250 calls
もっと必要ですか?カスタム企業料金についてお問い合わせください。
ドキュメントを離れる前に