Man page 转 RST转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
把 RST 文档转成 Markdown/Word 给非 Sphinx 读者；或把 Markdown 内容作为 RST 导入 Sphinx 项目。如果你的文件还是 Man page 格式，这个页面就是最快的捷径：Man 页是每个 Unix 命令背后的 roff 格式手册：.TH 头、.SH 节和 \fB 字体转义——至今仍在日常使用的最古老文档格式。
本转换器通过 WebAssembly 完全在你的浏览器内运行——文件不会离开你的设备，全程无上传、无水印、无注册、无排队。支持一次拖入多个文件批量转换。
Man page 与 RST 的对比
| Man page | RST | |
|---|---|---|
| 数据结构 | roff 宏（.TH/.SH、\fB 转义） | 纯文本 + 指令 |
| 最适合 | 命令行参考手册 | 技术文档 |
如何将 Man page 转换为 RST
- 1
选择文件
选择你的 Man page 文件。
- 2
立即转换
文件先转换成 Markdown（保留标题、列表与段落的中间格式），再重建为目标格式。
- 3
下载结果
下载 RST——结构保留，复杂排版被简化。
关于 Man page 格式
Man 页是 Unix 最古老且仍活着的文档格式：roff 源码带 .TH 标题宏、.SH 节头和 \fB 这类反斜杠字体转义，由 troff/groff 渲染成每个开发者用 `man ls` 阅读的终端页。它比多数仍在使用的编程语言都老——而且至今随每个 Linux 和 macOS 安装。
现代文档团队已很少手写 roff，但任何要出现在终端里的东西仍绕不开这个格式。Pandoc 把 man 页转成 Markdown、HTML 或 Word，让命令行文档上网——也能从 Markdown 源生成新的 roff。
+优点
- ✓所有类 Unix 系统通用
- ✓紧凑表达结构化手册
- ✓终端与印刷排版皆佳
!局限
- −对新手而言宏语法晦涩
- −roff 工具链古老
- −不适合富媒体或网页优先的文档
关于 RST 格式
reStructuredText 是 Python 世界标准化的标记语言：Sphinx 用它构建整套文档站，PyPI 用它渲染项目介绍，docutils 等工具链围绕它建立。标题用标点下划线标出，.. image:: 和 .. code-block:: 之类的指令在不破坏纯文本可读性的前提下扩展能力。
RST 比 Markdown 更严格是有意为之——正是这种严格让大型文档树保持一致。把 RST 转成 Markdown 或 Word 能让 Sphinx 项目向全团队开放；把 Markdown 转回 RST 则能喂给 Sphinx 构建。
+优点
- ✓Sphinx/Python 文档的原生格式
- ✓大规模下依然一致：指令、角色、交叉引用
- ✓表格与提示框是一等语法
!局限
- −普及度不如 Markdown
- −更严格的规则有学习成本
- −部分指令绑定特定工具链
为什么把 Man page 转换成 RST？
这个转换之所以存在，是有具体原因的：对新手而言宏语法晦涩RST 则绕开了这一点——Sphinx/Python 文档的原生格式如果你正处在这种情况，用上面的工具几秒就能解决，全程都在你自己的设备上。
常见问题
Man page 转 RST 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
Man page 转 RST 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
转换可以离线进行吗？
可以。页面加载完成后，转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。
转换出来的 RST 之后还能编辑吗？
取决于目标格式：RST 为自己的用途而生，本转换器忠实还原其内容，而不是凭空制造可编辑结构。需要大量再编辑时，请从面向编辑的格式入手，最后在这里导出终稿。