FORMAT COMPARISON
PDF vs Markdown
PDFとMarkdownは文書を共有できますが、PDFは見た目を固定した閲覧・印刷用の成果物、Markdownは編集・履歴管理しやすいテキスト原稿です。完成版を渡すか、更新する原稿を共有するかで選びます。
PDFとMarkdown、どちらを選ぶ？
レイアウトを保った資料を閲覧・印刷用に渡すならPDFを、技術文書やREADMEのようにテキストで更新・レビューを続けるならMarkdownを選びます。MarkdownからPDFを作る場合は、変換後の改行、表、画像、リンクを確認します。
PDF向き
文書配布・印刷用データ
- レイアウトを保つ共有
- 配布資料
Markdown向き
README・技術文書・差分管理する文書
- 見出し・リンク・コードを含む軽量な文書
- Gitで変更履歴を管理するドキュメント
基本情報を比較
PDFとMarkdownの主な違いを確認できます。
| 項目 | Markdown | |
|---|---|---|
| 拡張子 | .md、.markdown | |
| MIME Type | application/pdf | text/markdown |
| 主な用途 | 文書配布・印刷用データ | README・技術文書・差分管理する文書 |
| 開く方法 | ブラウザやPDFリーダーで開けます。 | テキストエディタ、Markdown対応エディタ、リポジトリのプレビュー機能で開けます。公開先での表示を確認するときは、そのサービスが採用する方言と拡張機能を確認します。 |
| 書き出し・変換 | 用途に応じて印刷、テキスト抽出、画像化などを行います。 | 用途に応じて対応する変換ツールでHTMLやPDFへ出力します。変換前に方言、画像・リンクの相対パス、コードブロックや表の対応状況を確認します。 |
用途別の選び方
作りたいものや使う場面から選べます。
レイアウトを保つ共有
文書配布・印刷用データ
PDF向き配布資料
文書配布・印刷用データ
PDF向き見出し・リンク・コードを含む軽量な文書
README・技術文書・差分管理する文書
Markdown向きGitで変更履歴を管理するドキュメント
README・技術文書・差分管理する文書
Markdown向き確認ポイント 1
PDFは固定レイアウトの文書を閲覧・配布する用途に適する
使い分け確認ポイント 2
Markdownはテキストで編集・差分管理しやすく、変換先の表示ルールに依存する
使い分け選ぶ理由を詳しく
- PDFは更新用の唯一の原稿にせず、Markdownなど編集元の管理方法を別に持つ