Markdown PDF 変換ツール

Markdown PDF 変換ツールは、Markdownソーステキストを固定レイアウトのPDFドキュメントに変換します。

Markdownは、見出し、段落、強調、リンク、リスト、テーブル、引用、コード、その他のドキュメント要素にプレーンテキストの構文を使用します。変換ツールはその構造を解釈し、サポートされている技術的コンテンツをレンダリングし、印刷スタイルを適用して、Markdownエディタがなくても共有、レビュー、アーカイブ、または印刷ができるPDFを作成します。

「MDからPDF」も同じ意味です。MDはMarkdownの一般的な略称であり、.mdはMarkdownドキュメントで一般的に使用されるファイル拡張子です。

.mdファイルは、プレーンテキストのMarkdownドキュメントです。SolConverterは.mdおよび.txtのソースファイルを受け入れ、オンラインワークフローを通じてサポートされているMarkdownコンテンツをPDFに変換します。

これは、Markdownを編集可能なソースとして維持しつつ、クライアント、同僚、学生、査読者、またはMarkdownを扱わない人々向けに安定したドキュメントが必要な場合に便利です。

同じタスクを表す一般的な表現には以下があります：

• MarkdownからPDF
• MDからPDF
• MarkdownファイルからPDF
• .mdファイルからPDF
• MarkdownをPDFに変換
• MarkdownをPDFとしてエクスポート
• MarkdownをPDFとして保存

これらの変換ニーズはすべて、このページで対応しています。

SolConverterは、技術文書や一般文書でよく使用されるMarkdown構造をレンダリングします。

サポートされているコンテンツは以下の通りです：

• ATXおよびSetextの見出し；
• 段落、改行、および水平線；
• 太字、斜体、および打ち消し線；
• 入れ子になったリストを含む、番号付きリストおよび箇条書きリスト；
• チェックボックス付きのGFMタスクリスト；
• 引用および入れ子になった引用；
• インラインコードおよびフェンス付きコードブロック；
• Markdownリンク、Web自動リンク、およびメール自動リンク；
• 左揃え、中央揃え、右揃えのGFMテーブル；
• 制御されたrowspanおよびcolspanを持つ安全な生のHTMLテーブル；
• details、summary、kbd、sub、sup、figure、およびfigcaptionなどのドキュメント要素；
• 見出しアンカー；
• ファイルの先頭にあるYAMLフロントマター（印刷コンテンツではなくメタデータとして処理されます）。

不適切な形式のコードフェンスやデリミタは、可能な限り局所的に処理されるため、フォーマットの問題がドキュメントの残りの部分に影響を与えることはありません。

SolConverterは、サポートされているLaTeXおよびMathMLをMathJax SVGとしてレンダリングします。SVG出力は、PDFをズームまたは印刷しても鮮明なまま保たれます。

数式パイプラインはMarkdown解析の前に式を認識するため、アンダースコア、アスタリスク、表示デリミタ、および数式環境がMarkdownパーサーによって変更されるのを防ぎます。

サポートされている数式入力は以下の通りです：

• $...$および\(...\)によるインライン数式；
• $$...$$および\[...\]によるディスプレイ数式；
• equation、align、gather、multline、split、casesなどの一般的なAMS環境；
• 分数、根、累乗、添字、総和、相乗、積分、極限、および級数；
• 行列、行列式、配列、およびテンソル表記；
• 微積分、微分方程式、線形代数、確率、統計、物理、および化学の表記；
• Presentation MathMLおよび基本的なContent MathML操作；
• \ce{...}で記述された化学式；
• \newcommandや\DeclareMathOperatorなどのドキュメントスコープのマクロ。

長い加算式は、ページの端で途切れたり読みにくくなるほど縮小されたりする代わりに、トップレベルの演算子で分割できます。ディスプレイ数式は、ブラウザがページ内にブロックを収められる限り、分割されずに配置されます。

SolConverterは、不適切な形式の数式を問題が発生した場所に隔離します。

LaTeXまたはMathMLブロックを安全にレンダリングできない場合、変換ツールはニュートラルなソースフォールバックを保持し、それに続く有効なコンテンツのレンダリングを続行します。この局所的なエラー処理アプローチは、ダイアグラムや画像にも適用されます。

これは長い技術文書において重要です。1つの破損した数式、1つの利用できない画像、または1つの無効なダイアグラムによって、周囲のすべての有効なページが自動的に破棄されるべきではありません。

サポートされているMermaidフェンスブロックは、PDF内でSVGとしてレンダリングされます。ZenUMLは、ローカルにバンドルされたMermaid外部ダイアグラム統合を介してサポートされます。

有効なダイアグラムはそれぞれ独立してレンダリングされ、使用可能なページ幅に制限されます。ダイアグラムの処理に失敗した場合、SolConverterはソースを含むローカルフォールバックを挿入し、残りのドキュメントの処理を続行します。

現在サポートされているダイアグラムエンジンはMermaidおよびZenUMLです。PlantUML、Graphviz、D2、WaveDrom、BPMN、Nomnoml、および完全なTikZは現在サポートされていません。

技術文書では、説明、コマンド、設定、ソースコードが混在することがよくあります。SolConverterは、コードフェンスの言語が認識されると、Highlight.jsを使用して構文ハイライトを適用します。

コード出力には以下が含まれます：

• 専用の等幅フォント；
• フェンスブロック用の表示可能な背景、境界線、およびパディング；
• コードフェンス情報文字列からの言語検出；
• 言語が認識されない場合の安全なソース出力；
• コード内の数式デリミタの解釈からの保護；
• 右書き（RTL）ドキュメント内のコードに対する左書き（LTR）の分離。

したがって、PDFはオリジナルのソースを保持しながら、コードを周囲の文章から視覚的に分離します。

SolConverterはコンテンツからドキュメントの方向を検出し、適切なフォントフォールバックを使用して多言語PDFをサポートします。

サポートされているテキストのシナリオには以下が含まれます：

• ベトナム語および拡張ラテン文字；
• アラビア語およびヘブライ語のレイアウト；
• 中国語、日本語、および韓国語のテキスト；
• インド系文字；
• キリル文字およびギリシャ文字；
• 複数言語が混在するドキュメント；
• 結合文字；
• 利用可能なフォントの範囲に応じた、多くのUnicode記号および絵文字。

ドキュメントの主な方向が右書きであっても、数式とコードは左書きのまま維持されます。

SolConverterは、公開されているHTTPおよびHTTPS画像、ならびにPNG、GIF、JPEG、WebP、およびSVG形式の有効なbase64データ画像をサポートしています。

画像はアスペクト比を維持しながらページ幅に制限されます。サポートされている画像のメタデータには、代替テキスト（alt）、タイトル、安全な寸法、配置、図、およびキャプションが含まれます。

利用できない、または無効な画像は、代替テキストを含むローカルプレースホルダーに置き換えられます。その後、変換ツールはPDF全体をエラーにするのではなく、残りのMarkdownの処理を続行します。

セキュリティのため、ローカルパス、localhostアドレス、プライベートIPリテラル、javascript: URL、およびサポートされていないスキームはブロックされます。リポジトリ相対のアセットフォルダは、アップロードされたMarkdownファイルと一緒に自動的にパッケージ化されません。

変換ツールは、技術文書、メモ、レポート、および印刷出力用に一貫したPDFレイアウトを適用します。

現在のウェブフォームは以下を使用します：

• A4ページサイズ；
• ポートレート（縦向き）；
• 読みやすい出力のための管理された余白；
• current / total形式のページ番号；
• ソースファイル名に基づく出力タイトル；
• 背景の印刷。

レンダリングシステムは、基本的な印刷レイアウト保護も適用します。ページの最下部に見出しが単独で残るのを防ぎ、テキストブロック内のウィドウ・オーファン（行の孤立）を減らし、ブラウザがサポートしている場合はテーブルヘッダーを繰り返し、十分なページスペースがある場合はコードブロック、テーブルの行、図、画像、ダイアグラム、およびディスプレイ数式の分割を回避します。

シンプルなMarkdownのエクスポートは容易です。しかし、長い技術文書のMarkdownは、数式、ダイアグラム、テーブル、コード、多言語テキスト、外部画像、およびページネーションがすべて相互に影響し合うため、難易度が高くなります。

SolConverterは、そのようなより要求の厳しいケースを想定して設計されています。そのMarkdownからPDFへのパイプラインには、MathJax SVGレンダリング、MermaidおよびZenUML、syntax highlighting、UnicodeおよびRTLサポート、サニタイズ、ネットワーク制御、ブロックレベルのエラー分離、ジョブの進行状況、ならびに個別のプレビューおよびダウンロード結果が含まれています。

アップロードされたMarkdownには、生のHTML、画像URL、および自動的に信頼すべきではないその他のコンテンツが含まれている可能性があります。

SolConverterは、許可リスト（アローリスト）を使用してレンダリングされたHTMLをサニタイズし、スクリプトやイベントハンドラを削除し、安全でないURLを拒否し、テーブルのスパンを制限し、制限的なコンテンツセキュリティポリシー（CSP）を適用し、画像ポリシーから外れるブラウザリクエストを傍受します。

有効なデータ画像は、ネットワークリクエストなしでレンダリングできます。公開されているリモート画像は画像ポリシーを通じて許可されますが、ローカル、プライベート、およびサポートされていない宛先はブロックされます。

変換が開始されない場合、新しいアップロードは15分後に期限切れになります。変換が成功すると、出力が確認された後にソースが削除されます。失敗した入力は元の15分間のウィンドウで期限切れになります。完成したPDFは最大2時間利用可能です。完全なライフサイクルについては、プライバシーポリシーをご覧ください。

Markdownは執筆やバージョン管理に効率的です。PDFは、ドキュメントに安定した外観と広くサポートされた配信フォーマットが必要な場合に便利です。

MarkdownをPDFに変換する必要があるケースには、以下のようなものがあります：

• ソースリポジトリの外部に技術文書を送信する；
• 固定されたレポート、仕様書、提案書、またはランブックを提供する；
• 印刷可能な学習用メモやトレーニング教材を作成する；
• 非技術者の読者にREADMEや変更履歴（チェンジログ）を配布する；
• ページベースの形式で数式やダイアグラムを確認する；
• 変更されるドキュメントの特定のバージョンをアーカイブする；
• Markdownエディタを必要とせずにドキュメントを共有する；
• 編集可能なMarkdownソースを保持し、別の配信ファイルを生成する。

オンラインのMarkdown PDF変換ツールは、ローカルのツールチェーンを設定することなく、直接のアップロード、管理されたレンダリング、プレビュー、およびダウンロードのワークフローを行いたい場合に最適です。

オフライン変換、カスタムテンプレート、任意のCSS、引用の処理、スクリプト化されたビルドパイプライン、またはリポジトリ内でのバッチ変換が必要な場合は、Pandocなどのローカルツールやエディタの拡張機能の方が適している場合があります。

SolConverterは、アップロードされた個々のドキュメントに対する、管理されたMarkdownからPDFへのレンダリングに焦点が当てられています。現在のところ、完全なPandocの引用サポート、任意のユーザーCSS、自動PDFブックマーク、パッケージ化された相対アセットフォルダ、またはすべてのダイアグラム言語のサポートは提供していません。

技術文書

アーキテクチャのメモ、APIの説明、ランブック、リリース文書、仕様書、および内部ガイドを安定したPDFに変換します。

数学・科学文書

サポートされているLaTeX、MathML、行列、数式、化学表記、および長い式を、PDF内のSVGベースの数式としてレンダリングします。

開発者向けドキュメント

コードフェンス、インラインコード、テーブル、タスクリスト、ダイアグラム、および構造化された説明を、リポジトリの外部でレビューできる1つのドキュメントにまとめます。

多言語レポート

ベトナム語、CJK（日中韓）、アラビア語、ヘブライ語、キリル文字、ギリシャ文字、インド系文字、および左書きと右書きが混在するコンテンツを含むPDFを作成します。

メモ、レポート、および提案書

Markdownで執筆し、印刷、承認、共有、またはアーカイブ用の固定レイアウトドキュメントを作成します。

ソース形式や希望する出力が異なる場合は、別のSolConverterツールを使用してください。

• ファイルをMarkdownに変換
• PDFをMarkdownに変換
• WordをMarkdownに変換
• HTMLをMarkdownに変換
• ExcelをMarkdownに変換
• CSVをMarkdownに変換
• データ変換ツールを閲覧
• JSONをCSVに変換
• CSVをJSONに変換