MarkdownCo
Developer API

開発者向け Markdown Converter API

単一の REST エンドポイントで Markdown・PDF・Word・HTML をプログラムから変換できます。LaTeX 数式と Mermaid 図を完全サポート。ホスト済みですぐに呼び出せるので、あらゆる言語から数分で変換を開始できます。RapidAPI で API キーを取得してください。

RapidAPI で API キーを取得するコード例を見る

Markdown 変換 API クイックスタート

2 回のリクエストで完了：ファイルを送信してタスク ID を取得し、ダウンロード URL をポーリングするだけです。すべてのエンドポイントが同じパターンに従います。

# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }

# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
  -d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }

1. 変換リクエストを送信する

ファイルアップロード（source_file）または公開ファイル URL（source_file_url）を送信すると、task_id が返されます。

2. 結果をポーリングする

task_id を指定して query-task をポーリングし、status が completed になったら to_url からダウンロードします。

YOUR_RAPIDAPI_KEY を RapidAPI ダッシュボードのキーに置き換えてください。X-RapidAPI-Host の値もダッシュボードで確認できます。

Markdown→PDF・Word・HTML API エンドポイント一覧

すべてのエンドポイントは multipart/form-data による POST を受け付け、task_id を返します。ベースパス：/apix

メソッドエンドポイント説明オンラインツール
POST/apix/md-to-pdfMarkdown を PDF に変換します。LaTeX と Mermaid をレンダリングします。オンラインで試す
POST/apix/md-to-docxMarkdown を編集可能な Word（.docx）ドキュメントに変換します。オンラインで試す
POST/apix/md-to-htmlMarkdown をクリーンなセマンティック HTML に変換します。オンラインで試す
POST/apix/pdf-to-mdPDF からテキスト・表・画像を含む Markdown を抽出します。オンラインで試す
POST/apix/docx-to-mdWord（.docx）ドキュメントを Markdown に変換します。オンラインで試す
POST/apix/html-to-mdHTML ページまたはフラグメントをクリーンな Markdown に変換します。オンラインで試す
POST/apix/query-tasktask_id でタスクをポーリングし、準備ができたらダウンロード URL を取得します。—

非同期変換 API の仕組み

変換は非同期で実行されるため、大きなファイルでもリクエストがブロックされません。

送信

Markdown・PDF・Word・HTML ファイルを、アップロードまたは公開 URL 経由で対応するエンドポイントに POST します。

タスク ID を受け取る

API はすぐに status が processing の task_id を返します。コネクションを長時間保持しません。

ポーリングとダウンロード

task_id を指定して query-task を呼び出し続け、status が completed になったらレスポンスの to_url からファイルをダウンロードします。

Markdown Converter API のレンダリング機能

LaTeX 数式から Mermaid 図まで、複雑な Markdown を PDF・Word・HTML に忠実に変換します。

LaTeX 数式

インライン・ブロック両方の LaTeX 数式を PDF および Word 出力に忠実にレンダリング。学術・技術ドキュメントに最適です。

Mermaid 図

フローチャート・シーケンス図・ガントチャート・クラス図など、Mermaid で記述した図を実際のグラフィックとしてレンダリングします。

GFM 完全対応

パイプテーブル・タスクリスト・シンタックスハイライト付きコードブロック・打ち消し線・自動リンクなど、すべて正確に保持されます。

双方向変換

Markdown から PDF・Word・HTML への変換はもちろん、逆方向にそれらのフォーマットをクリーンな Markdown に戻すことでバージョン管理も容易になります。

Markdown 変換 API のユースケース

ビルドパイプライン・プロダクト機能・バッチ処理など、あらゆる場面でドキュメント生成を自動化できます。

CI/CD パイプライン

ヘッドレスブラウザ不要で、毎ビルド時に Markdown からリリースノート・レポート・PDF アーティファクトを自動生成します。

ドキュメントツール

Markdown のドキュメントをユーザーや顧客向けにダウンロード可能な PDF・Word に自動変換し、オフライン閲覧にも対応します。

バッチ変換

公開ファイル URL を指定してサーバーサイドで大量のドキュメントを処理し、タスク ID で結果をまとめて収集できます。

Markdown Converter API 料金プラン

API は RapidAPI 経由で従量課金制です。無料ティアから始められ、利用量に応じてスケールする有料プランも用意されています。課金・API キー・レート制限はすべて RapidAPI アカウントで管理されます。

Basic

$0 / 月

30

リクエスト / 月

Pro

$7.90 / 月

800

リクエスト / 月

+ $0.02 / request

おすすめ

Ultra

$24.90 / 月

4,000

リクエスト / 月

+ $0.012 / request

Mega

$49.90 / 月

12,000

リクエスト / 月

+ $0.008 / request

クォータと料金は RapidAPI 上で設定されており、変更される場合があります。最新の詳細はライブプランでご確認ください。

RapidAPI でプランを確認する

Markdown API インテグレーション FAQ

サブスクライブ・認証・リクエスト送信・プラン選択まで、初めて利用する開発者が知りたいことをまとめました。

Markdown 変換 API を使い始めるには？

RapidAPI の無料アカウントを作成し、RapidAPI Hub で Markdown Converter Pro API を開いてプランにサブスクライブしてください。Basic プランは無料です。サブスクライブ後はすぐに、上記のコードサンプルを使って任意のエンドポイントを呼び出せます。

API キーはどこで確認できますか？

サブスクライブ後、RapidAPI からアカウント専用の API キーが発行されます。RapidAPI ダッシュボードおよび各エンドポイントの Code Snippets タブで確認できます。すべてのリクエストで X-RapidAPI-Key ヘッダーにキーを付与し、あわせて X-RapidAPI-Host ヘッダーも送信してください。

API はどの変換をサポートしていますか？

API には 6 つの変換エンドポイント（Markdown→PDF・Word・HTML、および PDF・Word・HTML→Markdown の逆変換）と、結果を取得するための query-task エンドポイントがあります。各エンドポイントの正確なパスは上記のエンドポイント一覧をご参照ください。

変換リクエストに必要なパラメーターは何ですか？

各変換エンドポイントは multipart/form-data リクエストを受け付け、source_file（ファイルを直接アップロード）または source_file_url（公開アクセス可能なファイルを指定）のいずれかを使用します。両方送信した場合は source_file が優先されます。ファイルサイズは最大 50 MB で、ファイル種別はエンドポイントに合致している必要があります（例：md-to-pdf には .md ファイルが必要です）。

変換済みファイルはどのように取得しますか？

変換は非同期で実行されるため、リクエストが成功するとファイル本体ではなく task_id が返されます。その task_id を query-task エンドポイントに渡してポーリングを続け、status が completed になったらレスポンスの to_url から完成したファイルをダウンロードしてください。

変換が失敗した場合はどうなりますか？

変換を完了できない場合、query-task は completed ではなく failed を返します。主な原因は、エンドポイントと一致しないファイル種別・公開アクセスできない source_file_url・50 MB を超えるファイルなどです。入力内容を修正して再度リクエストを送信してください。

どの料金プランを選べばよいですか？

まず無料の Basic プランでインテグレーションをテストし、月間リクエスト数が増えたら有料プランにアップグレードしてください。各プランには月間リクエストクォータがあり、超過分は少額の従量料金が発生します。現在のプラン詳細は上記の料金表でご確認ください。課金と制限は RapidAPI アカウントで管理されます。

変換後のファイルはどう扱われますか？

ファイルは保持されません。アップロードされたドキュメントと変換後の出力は一時的に処理された後に削除されます。完成したファイルは長期保存されず、有効期限付きのダウンロード URL から提供されます。

数分で変換を始めましょう

RapidAPI でサブスクライブして API キーを取得し、今すぐ最初の変換リクエストを送信してください。

RapidAPI で始める