Markdown to PDF
v1.0REST API

API ドキュメント

プログラムで Markdown を PDF に変換します。当社の REST API を使用すると、単一の HTTP リクエストで Markdown コンテンツからプロフェッショナルでスタイルされた PDF を生成できます。

クイックスタート

簡単な curl コマンドで 30 秒で PDF を生成します。

1

API キーを取得

ダッシュボードの API Keys からキーを生成します。

2

Markdown を書く

様々な見出し、リスト、コードブロック、表、画像など、有効な Markdown をすべてサポートします。

3

リクエストを実行

キーと Markdown を使って POST リクエストを送信します。PDF が戻されます。

cURL
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

リクエストヘッダー

ヘッダー説明
AuthorizationBearer mp_live_...Bearer を接頭した API キー
Content-Typeapplication/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)。

リクエスト例

Python
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)
JavaScript
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

Clean

ミニマルで現代的なサンセリフデザイン、クリーンなスペーシング。

executive

Executive

シリフ見出し、プロのネイビーアクセントとページ番号。

resume

Resume

職歴書に最適化されたコンパクトな単一カラムレイアウト。

academic

Academic

番号付き見出し、ゆったりしたスペーシング、EB Garamond ボディ。

legal

Legal

ダブルスペースのシリフボディ、正式な引用フォーマット。

creative

Creative

太字 DM Sans 見出し、設定可能なアクセントカラー。


エラーコード

各応答は標準の HTTP ステータスコードを使用します。これを使って結果の処理方法を決定してください。

ステータス意味アクション
200成功 — PDF を返却応答ボディから PDF をダウンロードします。
400不正なリクエストボディJSON ペイロードが上記のスキーマに一致することを確認してください。
401不正または欠癖した API キーAPI キーがアクティブで正しくフォーマットされていることを確認してください。
402API クレジット不足ダッシュボードからクレジットを追加購入してください。
404カスタムテンプレートが見つかりませんcustomTemplateId が正しく、自分のものであることを確認してください。
415不正な Content-TypeContent-Type ヘッダーを application/json に設定してください。
422不正な変換オプションoptions オブジェクトが仕様に合っていることを確認してください。
429レート制限に達しました待機して再試行してください。Retry-After ヘッダーを確認してください。
500サーバーエラー指数的バックオフで再試行してください。継続する場合はサポートにお問い合わせください。

API 料金

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

Free

$0

25 / month

テスト・評価用。

Starter

$9

500 / month

個人や小規模プロジェクト向け。

Pro

$29

1,000 / month

優先生成、API を通じたカスタムテンプレートサポート。

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