Pandoc engine · in-browser · private

reStructuredText に変換

14 の文書形式を Sphinx ですぐ使える reStructuredText に変換します。Pandoc の RST ライターはディレクティブ、ロール、表を処理 — Python ドキュメントプロジェクトに最適です。

Click to start converting

Go to Pandoc engine — reStructuredText output selected automatically

Supported input formats

Pandoc の RST ライターは文書ツリーを reStructuredText の規約にマッピングします: 見出しレベルは一貫した下線スタイルに、箇条書きはダッシュに、定義リストは構造を保ったまま、表は複雑さに応じてグリッドまたはシンプル構文で出力されます。

ライターは標準の RST を対象とするため、出力はそのまま Sphinx プロジェクトに収まります — toctree、code-block ディレクティブ、note も手作業の修正なしで処理されます。Word の仕様書から Read the Docs のページへの最短ルートです。

変換は WebAssembly により完全にブラウザ内で実行されます。アップロードされるものは何もありません。

RST は Markdown よりも見出しの下線に厳密ですが、Pandoc は一貫して生成します — 後から手作業で見出しレベルを再構成する場合は、下線の長さをタイトルテキスト以上に保ってください。

Word のコンテンツには相互参照のセマンティクスがないため、:ref: や :doc: のようなロールは自動的には作られません — 変換後に追加してください。Pygments にハイライトさせるには、code-block ディレクティブの後に明示的な言語指定が必要な場合があります。

非常に幅の広い Word の表は RST の読みやすいグリッド幅を超えることがあります。分割するか、該当セクションを後から list-table に変換することを検討してください。

要件文書や設計文書を Sphinx へ移行する Python チーム、wiki のエクスポートを Read the Docs に移すメンテナー、Markdown ではなく docutils で標準化するプロジェクト向けに reStructuredText を用意するテクニカルライター。

+出力は Sphinx と互換性がありますか？

はい。Pandoc の RST ライターは、Sphinx が直接処理できる標準の reStructuredText を生成します — ディレクティブ、ロール、コードブロックすべてが動作します。

+Word 文書を RST に変換できますか？

はい。.docx をドロップして reStructuredText 出力を選択すれば、Sphinx ですぐ使える .rst ファイルが得られます。見出し、表、脚注が保持されます。

+Markdown ではなく RST を使う利点は？

RST はディレクティブ (.. note::、.. code-block::)、ロール (:ref:、:doc:)、拡張表に対応しています — Markdown にない機能です。Python や科学技術ドキュメントの標準です。