把 Markdown 转成 RST,给 Sphinx 和 Python 文档用,标题下划线对齐、行内码双反引号、链接转 `text <url>`_,全程浏览器本地
- 本地处理
- 分类 格式转换
- 适合 把粘贴内容或本地文件转成更适合交付的格式。
这个工具能做什么
免费的 Markdown 转 reStructuredText 工具,给 Sphinx、Read the Docs 以及任何文档放在 .rst 文件里的 Python 项目用。左边粘 Markdown, 右边读干净的 RST。工具会改写两种格式所有不一样的地方:ATX 标题变成 标题行加一行标点下划线,下划线宽度对齐标题文字;行内 `code` 变成 双反引号 ``code``;[文字](网址) 链接变成 RST 的 `文字 <网址>`_ 写法; 围栏代码块变成 .. code-block:: 指令,正文缩进三个空格;单独一行的图片 变成 .. image:: 指令。粗体和斜体原样保留,因为 RST 本来就用 **粗体** 和 *斜体*。列表、有序编号和引用块都会带过去。全部在浏览器标签页里跑, 一键复制,分享链接能还原你的输入。
工具细节
- 输入
- 文本 + 数值 + 结构化内容
- 页面会根据工具类型展示文本框、数值控件、文件选择或结构化输入。
- 输出
- 即时结果 + 复制 + 预览
- 结果区优先给出可操作结果,支持项会显示复制、下载或可视化预览。
- 隐私
- 浏览器本地处理
- 主工具逻辑未发现外部 API 调用,输入通常留在当前标签页内处理。
- 保存 / 分享
- 可分享链接状态
- 关键设置会进入 URL,复制链接后别人能复现同一组参数。
- 性能预算
- 首屏 JS ≤ 9 KB
- 没有声明 WASM 依赖,适合快速打开和移动端使用。
- 适用场景
- 格式转换 · 程序员
- 分类和职业标签用于推荐相关工具、组织内链,并帮助用户快速判断是否适合当前任务。
怎么用
-
1. 输入
把内容粘贴或拖入工具面板。
-
2. 处理
点击按钮,在浏览器内本地处理,文件不上传。
-
3. 复制 / 下载
一键复制结果或下载到本地。
Markdown 转 reStructuredText 适合怎么用
适合把内容从一种实际格式转成另一种可用格式。
适合转换的任务
- 把粘贴内容或本地文件转成更适合交付的格式。
- 放进大流程前,先预览转换结果是否可靠。
- 修正常见格式不匹配,不用打开完整编辑器。
转换检查项
- 源格式比较乱时,先拿一小段试转。
- 转换后检查编码、分隔符和换行符。
- 结果确认前保留原始内容。
下一步可以接着做
这些入口会把当前任务接到更完整的工具链里。
真实使用场景
把 README 搬进 Sphinx 文档树
项目的 README 是 Markdown,但文档站用 Sphinx 构建,要的是 .rst。 把 README 粘进来,拿到标题带下划线、代码围栏转成 code-block 指令、 链接改写成 `text <url>`_ 的 RST,再放进 docs/intro.rst。不用一个个 反引号、一个个链接手动改。
把 GitHub wiki 页面搬到 Read the Docs
团队 wiki 是用 Markdown 写的,现在要放到 Read the Docs 上,那边 渲染的是 RST。一次粘贴就转好,项目符号列表和引用块原样保留,顶部 那张图片会变成规范的 .. image:: 指令,而不是 RST 会当成字面文字 渲染的那个坏掉的 ![]()。
用 Markdown 起草,按 RST 交付
你用 Markdown 想得更快,编辑器预览的是它,笔记也是它。页面先用 Markdown 写,粘到这里,再把 RST 结果提交进 Sphinx 仓库。你保住了 Markdown 的写作速度,工具链也拿到了它要的 RST。
修复粘贴后坏掉的代码段
有人把 Markdown 直接粘进 .rst 文件,每个 `code` 段都失了义,因为 RST 要双反引号。把原始 Markdown 在这里跑一遍,行内代码就变成 ``code``,整页的等宽字面渲染又回来了。
常见踩坑
标题下划线写太短。RST 要求下划线那行至少和标题文字一样宽,否则 Sphinx 会报警告,甚至丢掉这个标题。本工具自动把下划线对齐标题,所以「Setup」总是正好五个等号。
把行内代码留成单反引号。RST 里单反引号是解释型文本角色,不是字面代码,从 Markdown 粘来的 `value` 含义会被悄悄改掉。要用工具生成的双反引号 ``value`` 写法。
保留 Markdown 链接语法。RST 不认 [文字](网址),它要 `文字 <网址>`_,带尖括号和结尾下划线。粘进 Markdown 写法,链接会在渲染页面上变成看得见的字面文字。
隐私说明
整个转换,标题下划线、code-block 指令、链接改写、每一步正则, 都是浏览器标签页里运行的纯 JavaScript。你的 Markdown 不会上传,也不 记录你粘了什么。唯一要注意:分享链接会把输入写进查询字符串,所以把 分享链接粘到聊天里,对方服务器的访问日志会留下那段文字。涉及内部 文档,请用复制按钮直接粘贴 RST,而不是分享网址。
常见问题
类似工具组合
做你这行的人, 还会一起用这些。