API ドキュメント
プログラムで Markdown を PDF に変換します。当社の REST API を使用すると、単一の HTTP リクエストで Markdown コンテンツからプロフェッショナルでスタイルされた PDF を生成できます。
クイックスタート
簡単な curl コマンドで 30 秒で PDF を生成します。
API キーを取得
ダッシュボードの API Keys からキーを生成します。
Markdown を書く
様々な見出し、リスト、コードブロック、表、画像など、有効な Markdown をすべてサポートします。
リクエストを実行
キーと Markdown を使って POST リクエストを送信します。PDF が戻されます。
curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
-H "Authorization: Bearer mp_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello World\n\nThis is a **test**.", "templateId": "clean"}' \
-o output.pdf認証
apiDocs.authentication.description
リクエストヘッダー
| ヘッダー | 値 | 説明 |
|---|---|---|
| Authorization | Bearer mp_live_... | Bearer を接頭した API キー |
| Content-Type | application/json | すべてのリクエストに必須 |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Markdown をスタイルされた PDF ドキュメントに変換します。
リクエストボディ
markdownstring必須変換する Markdown コンテンツ。最大 200,000 文字。
templateIdstring任意使用するテンプレート。clean, executive, resume, academic, legal, creative のいずれか。デフォルト: clean。
filenamestring任意ダウンロードされる PDF ファイルの名前。デフォルト: document.pdf。
localestring任意レンダリング用のロケール。en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it のいずれか。デフォルト: en。
customTemplateIdUUID任意保存されたカスタムテンプレートの UUID。テンプレートは API キーのユーザーが所有する必要があります。
optionsobject任意変換オプション: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber)。
リクエスト例
import requests
api_key = "mp_live_your_api_key_here"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"markdown": "# Quarterly Report\n\n## Revenue\n\nRevenue grew **15%** this quarter.",
"templateId": "executive",
"options": {"pageNumbers": True}
}
response = requests.post(
"https://markdowntopdfconverter.com/api/v1/convert",
json=payload,
headers=headers
)
with open("report.pdf", "wb") as f:
f.write(response.content)const response = await fetch(
"https://markdowntopdfconverter.com/api/v1/convert",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
markdown: "# Invoice\n\n**Amount:** $1,200\n\n| Item | Qty | Price |\n| --- | --- | --- |\n| Widget | 5 | $240 |",
templateId: "clean",
filename: "invoice",
}),
}
);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Trigger download
const a = document.createElement("a");
a.href = url;
a.download = "invoice.pdf";
a.click();テンプレート
プロに設計された 6 つのテンプレートから選択できます。各テンプレートは、独自のタイポグラフィ、スペーシング、カラースキームを備えています。
Clean
ミニマルで現代的なサンセリフデザイン、クリーンなスペーシング。
Executive
シリフ見出し、プロのネイビーアクセントとページ番号。
Resume
職歴書に最適化されたコンパクトな単一カラムレイアウト。
Academic
番号付き見出し、ゆったりしたスペーシング、EB Garamond ボディ。
Legal
ダブルスペースのシリフボディ、正式な引用フォーマット。
Creative
太字 DM Sans 見出し、設定可能なアクセントカラー。
エラーコード
各応答は標準の HTTP ステータスコードを使用します。これを使って結果の処理方法を決定してください。
| ステータス | 意味 | アクション |
|---|---|---|
| 200 | 成功 — PDF を返却 | 応答ボディから PDF をダウンロードします。 |
| 400 | 不正なリクエストボディ | JSON ペイロードが上記のスキーマに一致することを確認してください。 |
| 401 | 不正または欠癖した API キー | API キーがアクティブで正しくフォーマットされていることを確認してください。 |
| 402 | API クレジット不足 | ダッシュボードからクレジットを追加購入してください。 |
| 404 | カスタムテンプレートが見つかりません | customTemplateId が正しく、自分のものであることを確認してください。 |
| 415 | 不正な Content-Type | Content-Type ヘッダーを application/json に設定してください。 |
| 422 | 不正な変換オプション | options オブジェクトが仕様に合っていることを確認してください。 |
| 429 | レート制限に達しました | 待機して再試行してください。Retry-After ヘッダーを確認してください。 |
| 500 | サーバーエラー | 指数的バックオフで再試行してください。継続する場合はサポートにお問い合わせください。 |
API 料金
API コールは月次でトラックされます。各成功した変換は、お客様のティアの月次制限にカウントされます。
$0
25 / month
テスト・評価用。
$9
500 / month
個人や小規模プロジェクト向け。
$29
1,000 / month
優先生成、API を通じたカスタムテンプレートサポート。
もっと必要ですか?カスタム企業料金についてお問い合わせください。