转换为 reStructuredText
将 14 种文档格式转为 Sphinx 可用的 reStructuredText。Pandoc 的 RST writer 处理指令、role 和表格——Python 文档项目的理想选择。
点击开始转换
跳转到 Pandoc 引擎，自动选择 reStructuredText 输出
支持的输入格式
| 格式 | 扩展名 | 说明 |
|---|---|---|
| Word (docx) | .docx | 标题、表格、脚注、图片、修订痕迹 |
| LibreOffice (odt) | .odt | 段落样式、母版页、内嵌媒体 |
| 电子书 (epub) | .epub | 章节结构、书籍元数据、图片 |
| HTML | .html | 标题、列表、表格、链接——真正的 HTML reader |
| LaTeX | .tex | 数学、环境、引文 |
| reStructuredText | .rst | 指令、role、表格 |
| Org-mode | .org | 标题、属性、抽屉块 |
| CSV | .csv | Pandoc 渲染为 GFM 管道表格 |
| TSV | .tsv | 制表符分隔，渲染为管道表格 |
| MediaWiki | .mediawiki | 模板、链接、表格 |
| DocBook | .docbook | 文章、章节、媒体对象 |
| OPML 大纲 | .opml | 嵌套大纲 → 标题层级 |
| Jupyter notebook | .ipynb | 代码 cell、输出、Markdown cell |
转换是怎么工作的
Pandoc 的 RST writer 把文档树映射为 reStructuredText 的书写惯例：标题层级变成统一风格的下划线、无序列表变成短横线、定义列表保留结构，表格则按复杂度输出为 grid 或 simple 语法。
因为 writer 面向标准 RST，产物可以直接放进 Sphinx 项目——toctree、code-block 指令和 note 提示块都能无人工修整地通过编译。这是把 Word 规格文档搬进 Read the Docs 的最短路径。
转换完全在你的浏览器里通过 WebAssembly 完成，不上传任何内容。
常见问题与解决办法
RST 对标题下划线的要求比 Markdown 严格，但 Pandoc 生成的风格是一致的——如果你事后手工调整标题层级，注意下划线长度至少要与标题文字等长。
Word 内容本身不携带交叉引用语义，:ref:、:doc: 这类 role 不会替你生成——转换后再补。代码块可能需要在 code-block 指令后显式写语言，Pygments 才会高亮。
特别宽的 Word 表格可能超出 RST 可读的网格宽度；建议拆分表格，或事后把该节改写成 list-table。
谁在用这个页面
把需求文档和设计文档迁入 Sphinx 的 Python 团队、把 Wiki 导出搬到 Read the Docs 的维护者，以及为标准采用 docutils 而非 Markdown 的项目准备 reStructuredText 的技术写作者。
转换为 RST 常见问题
+输出兼容 Sphinx 吗？
兼容。Pandoc 的 RST writer 产出标准 reStructuredText，Sphinx 直接处理——指令、role 和代码块都能工作。
+能将 Word 文档转为 RST 吗？
能。拖入 .docx 选择 reStructuredText 输出，得到 Sphinx 可用的 .rst 文件。标题、表格、脚注全部保留。
+为什么用 RST 而不是 Markdown？
RST 支持指令（.. note::、.. code-block::）、role（:ref:、:doc:）和扩展表格——Markdown 没有这些特性。它是 Python 和科学文档的标准。