Markdown を PDF に変換 – MD ファイルを見やすい PDF に

FileReshape の Markdown から PDF への変換ツールは、.md ファイルを GitHub 形式の見出し、リスト、表、コードブロック、タスクリストでブラウザー内で整形し、ブラウザーの印刷ダイアログから文字を選択できる PDF として保存します。ファイルはアップロードされません。埋め込まれずリンクだけの画像は説明文で表示され、シンタックスハイライトや直接ダウンロードのボタンはありません。

うまく変換できないファイルがありましたか? [email protected] までメールでお知らせください。小さなサンプルファイルを添えていただけると、修正しやすくなります。

要点

Markdown を PDF にする理由

Markdown は、開発者やライター、Obsidian、Joplin、Typora などのメモアプリがテキストを保存する形式です。プレーンテキストのままでも読め、アプリで表示すれば整形されます。ところがそうしたアプリの外では、.md ファイルはシャープ記号とアスタリスクだらけの文字の壁にすぎず、取引先にメールしたり、提出したり、印刷したりするには向きません。このツールは、GitHub Flavored Markdown のルールに沿ったオープンソースのパーサー marked を使ってブラウザー内で Markdown を読み込み、きれいな文書にレイアウトします。見出し、太字や斜体、番号付きリストと箇条書き、チェックボックス付きのタスクリスト、罫線付きの表、引用、そしてページからはみ出さずに折り返す等幅フォントのコードブロックです。最後にブラウザー自身の印刷エンジンが PDF を書き出すため、文字はくっきりとしたまま検索もできます。ブログや静的サイトジェネレーターが使う、ファイル先頭の YAML フロントマターは PDF に含まれません。

Markdown を PDF に変換する方法

  1. .md ファイルをボックスにドロップするか、クリックして選択します。整形された文書のプレビューが表示されます。
  2. 「用紙サイズ」「余白」「文字サイズ」を選びます。
  3. 「PDF を作成」をクリックします。ブラウザーの印刷ダイアログで、プリンターまたは送信先として「PDF に保存」を選び、ファイルを保存します。

Markdown と PDF で知っておきたいポイント

リンクだけの画像

Markdown では、画像を ![Logo](images/logo.png) やウェブのリンクのように、アドレスで指定するのが普通です。このツールが受け取るのは .md ファイルだけで、その周りのフォルダーはなく、ウェブから何かを取得することもないため、こうした画像は説明文入りの小さな枠として表示されます。データ URL としてファイルに埋め込まれた画像は印刷されます。それ以外の画像を PDF に入れたい場合は、画像を表示できるエディターで Markdown を開き、そこから印刷してください。

Markdown 内の HTML

<br>、<sup>、<details> や HTML で書かれた表など、簡単な HTML はそのまま残ります。スクリプト、フレーム、フォーム、スタイル、埋め込み動画は、印刷する文書には不要で安全でない場合もあるため削除されます。

シンタックスハイライトはなし

コードブロックは薄い枠付きの等幅フォントで印刷されますが、エディターがキーワードや文字列に付ける色はありません。長いコードの行は折り返されるので、ページの端で切れることはありません。

Markdown の方言

表、タスクリスト、取り消し線、自動リンクは、多くのアプリが採用している GitHub のルールに従います。脚注、数式、Mermaid の図、ノート間のウィキリンク、Obsidian のコールアウトなど、一部のアプリにしかない拡張は、そのままのテキストとして表示されます。

ファイル形式について

Markdown

Markdown は、書式付きの文書をプレーンテキストで書くための形式で、2004 年に John Gruber 氏が作りました。シャープ記号で見出し、アスタリスクで太字や斜体、ハイフンで箇条書きを表します。 GitHub、GitLab、Reddit、Obsidian、Notion のエクスポート、多くのドキュメントツールで使われています。

  • .md ファイルはプレーンテキストなので、どのテキストエディターでも開け、Git などのバージョン管理とも相性が良い形式です。
  • GitHub Flavored Markdown(GFM)では、元の記法に表、タスクリスト、取り消し線、自動リンクが加わります。
  • 画像は通常アドレスでリンクされるため、.md ファイルと同じ場所の別ファイルか、ウェブ上に置かれます。

PDF

PDF(Portable Document Format)は 1993 年に Adobe が開発し、2008 年から ISO 規格になっています。 どの端末でも同じように表示されるため、契約書、請求書、申込書、マニュアル、スキャンした書類に使われます。

  • 1ページにテキスト、ベクター図形、写真をそれぞれ正確な位置に配置できます。
  • スキャンした書類は、たいてい1ページが1枚の画像です。
  • 開くときや編集するときに必要なパスワードで保護できます。

よくある質問

Markdown ファイルはアップロードされますか?

いいえ。Markdown はお使いの端末上でブラウザーが読み込んで整形し、PDF はブラウザーの印刷機能が書き出します。サーバーには何も送信されません。

各ページに入る日付やウェブアドレスを消すには?

ブラウザーの印刷ダイアログで、たいてい「詳細設定」の中にある「ヘッダーとフッター」をオフにしてください。上部のページタイトルも一緒に消えます。

PDF でコードブロックの灰色の背景が消えるのはなぜですか?

ブラウザーは、印刷ダイアログで「背景のグラフィック」をオンにしない限り、印刷時に背景色を省きます。コードブロックの枠はどちらの場合も印刷されます。

GitHub の README を変換できますか?

はい。README.md ファイルをダウンロードして、ここにドロップしてください。ウェブからリンクされたバッジやスクリーンショットは説明文で表示されます。