MarkdownをPDFに変換

使い方

1. 1Markdownを入力欄に貼り付けるか、デバイス内の.md、.markdown、.txtファイルを「ファイルを選択」から開きます。
2. 2プレビューで文書の表示を確認します。変換の前に仕上がりを見られます。
3. 3用紙サイズ、余白、文字サイズ、向きを選びます。
4. 4「PDFに変換」をクリックします。アカウント登録なしで使う場合は、セキュリティ確認が必要です。ログインしているユーザーはセキュリティ確認を省略できます。
5. 5PDFをダウンロードします。結果は10分後に削除されます。変換したら早めに保存してください。

出力例

Markdown PDF 変換の方法

Markdown PDF 変換は、三つの段階で進みます。まず、ブラウザのタブでMarkdownをHTMLに変換します。次に、整えたHTMLをレンダリングエンジンに送り、ヘッドレスChromium（画面を持たないブラウザエンジン）でPDFに印刷します。最後に、ファイルをダウンロードします。

ソフトウェアのインストールは不要で、アカウントも必要ありません。アカウント登録なしで使う場合は、セキュリティ確認が必要です。ログインしているユーザーはセキュリティ確認を省略し、クレジットを使います。

透かしは追加されません。PDFの本文はゴシック体で、上位2階層の見出しには罫線が入ります。コードブロックは灰色で、表には罫線が付き、引用にはスタイルが付きます。Markdownに独自のスタイルを書く必要はありません。

対応しているMarkdownの機能

変換ツールはGitHub Flavored Markdownに対応しています。次の機能が有効です。

• 表は罫線付きで印刷されます
• タスクリストは、未完了の項目に「- [ ]」、完了した項目に「- [x]」を使います
• 取り消し線付きの文字
• URLをそのまま書いた自動リンク
• Markdown内に入力したHTMLは印刷前に整えられ、スクリプトとイベント属性は削除されるため、PDF内では動作しません

READMEファイルと画像の扱い

README.mdは、ファイルを開くか本文を貼り付けるだけで変換できます。見出し、リスト、表、コードブロックは構成を保ったまま印刷されます。

画像は、公開されたhttps://またはhttp://のリンク、もしくはdata:URLで使えます。./img/a.pngのような相対パスは読み込まれません。変換ツールはファイルのフォルダーを見られません。

画像が表示されない場合は、先に新しいブラウザタブでその画像のアドレスを開いてください。ご自身で開けないリンクは、PDFにも読み込まれません。

コードブロックと表

言語名を開始のフェンスの後に書いたコードブロックには、構文の色が付きます。例えば、```pythonのように書きます。

色付けに対応している言語は、JavaScript、TypeScript、Python、JSON、Shell、CSS、HTMLとXML、SQL、Go、Rust、Java、C、C++、C#、PHP、Ruby、YAML、Markdown、Diff、Kotlin、Swiftです。言語がない場合や一覧にない場合は、灰色の背景の通常の文字になります。

横幅の広い表は、向きで横向きを選ぶと、行の幅を広く取れます。

用紙サイズ、余白、文字サイズ

用紙サイズは、A4、Letter、Legal、A3、A5から選べます。余白はミリメートル単位で指定します。

文字サイズは9ptから14ptまでです。小さくすると多くの文字が入り、大きくすると紙で読みやすくなります。

向きは横向きのオンとオフを選べます。背景を印刷するかどうかも選べます。灰色のコードブロックも背景に含まれます。

対応していない機能

このツールはMarkdownの文書を変換するためのものです。次の機能は対応していません。

• LaTeX数式は描画されません
• Mermaid図は描画されません
• 脚注は対応していません
• ファイル先頭のフロントマターは扱われません
• Web版では目次、ページ番号、ヘッダー、フッターは追加されません
• APIではヘッダーとフッターを追加でき、そのテンプレートでページ番号を表示できます（APIの項を参照）

変換が行われる場所

Markdownの読み込みとHTMLへの変換は、ブラウザで行われます。HTMLはブラウザ内で整えられ、その後レンダリングエンジンに送られます。レンダリングエンジンが受け取るのは.mdファイルそのものではありません。

レンダリングエンジンは、リソースを制限したワーカーコンテナ内のChromiumでHTMLを読み込みます。ジョブごとに厳格な時間の上限があります。エンジンはページをPDFに印刷し、ダウンロード用に結果を保存します。

変換ごとに新しいブラウザのコンテキストを使い、Cookieとキャッシュはジョブの間で共有されません。結果は10分後に削除されます。変換の履歴は保存されません。

APIでのMarkdownからPDFへの変換

コードからMarkdownを変換するには、Markdownライブラリを使ってMarkdownをHTMLに変換し、そのHTMLをhtml_to_pdfリクエストとしてAPIに送ります。APIが受け取るのはMarkdownではなくHTMLです。最初の変換はコードの中で行います。

APIキーは、AuthorizationヘッダーにBearerトークンとして送ります。

curl -X POST https://api.aiipworld.com/v1/render \
  -H "Authorization: Bearer $AIIPWORLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Release notes</h1><p>This HTML came from a Markdown file.</p>","output":"pdf","options":{"format":"A4"}}'

# returns {"job_id": "...", "status": "queued"}; then poll:
curl https://api.aiipworld.com/v1/jobs/JOB_ID -H "Authorization: Bearer $AIIPWORLD_API_KEY"

レンダリングの呼び出しは202を返し、job_idを含みます。GET /v1/jobs/:id を、ステータスがsucceeded、failed、timeoutのいずれかになるまで繰り返し確認します。成功したら、download_urlからファイルをダウンロードします。これは短期間で有効な署名付きリンクです。

Node.jsの例では、Web版と同じライブラリであるmarkedを使い、README.mdをHTMLに変換します。スタイル要素を追加して、PDFに独自のCSSを適用する方法も示しています。その後、ページをAPIに送ります。サンプルファイルは [FILE: node/markdown-to-pdf.mjs] です。

Markdownには生のHTMLを含められます。文章が自分のものでない場合は、先に整えてください。Web版ではDOMPurifyでブラウザ内のHTMLを整えています。失敗したジョブとタイムアウトしたジョブのクレジットは返却されます。一括処理用のエンドポイントはないため、1リクエストにつき1文書です。Webhookと、JSONデータを使うテンプレートは、まだ利用できません。APIはヘッダー、フッター、ページ番号を追加できますが、Web版では追加できません。

READMEとGitHubのファイルの利用

READMEをPDFにする場合は、README.mdを開くか、本文を貼り付けます。見出し、リスト、コードブロックは構成が保たれ、紙でも読みやすくなります。

GitHub Markdownの表、タスクリスト、取り消し線、自動リンクに対応しています。ただし、PDFは独自の文書スタイルを使うため、GitHubのページの見た目とは完全には一致しません。

フォントと日本語などの文字

PDFは、レンダリングサーバーにあるフォントを使います。お使いのデバイスにインストールされたフォントは使えないため、エディタの表示とは異なる場合があります。

サーバーのフォントで表示できる文字は、中国語、日本語、韓国語を含めて印刷されます。絵文字はNoto Color Emojiで描画されます。

mdファイルをPDFに変換する方法

.mdファイルは、Markdownで書かれたプレーンテキストのファイルです。変換ツールはテキストとして読み込みます。ファイルを開くか内容を貼り付け、プレビューを確認してから変換します。エディタもアカウントも必要ありません。

変換は、ブラウザのタブでMarkdownをHTMLにし、レンダリングサーバーがHTMLをPDFに印刷して行われます。ブラウザがあれば、どのデバイスからでもオンラインのツールとして使えます。別の用紙サイズや余白にしたい場合は、設定を変えてもう一度変換します。

よくある質問