跳到主要内容

Markdown 转 reStructuredText 转换器

把 Markdown 转成 RST,给 Sphinx 和 Python 文档用,标题下划线对齐、行内码双反引号、链接转 `text <url>`_,全程浏览器本地

  • 本地处理
  • 分类 格式转换
  • 适合 把粘贴内容或本地文件转成更适合交付的格式。
Sphinx 和多数 Python 文档读的是 reStructuredText,不是 Markdown。左边粘 Markdown,标题、**粗体**、*斜体*、`代码`、围栏块、链接、图片、列表和引用,右边出 RST,直接放进 .rst 文件。全部在这个标签页里跑。
Markdown
reStructuredText189 字符

这个工具能做什么

免费的 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. 1. 输入

    把内容粘贴或拖入工具面板。

  2. 2. 处理

    点击按钮,在浏览器内本地处理,文件不上传。

  3. 3. 复制 / 下载

    一键复制结果或下载到本地。

Markdown 转 reStructuredText 适合怎么用

适合把内容从一种实际格式转成另一种可用格式。

适合转换的任务

  • 把粘贴内容或本地文件转成更适合交付的格式。
  • 放进大流程前,先预览转换结果是否可靠。
  • 修正常见格式不匹配,不用打开完整编辑器。

转换检查项

  • 源格式比较乱时,先拿一小段试转。
  • 转换后检查编码、分隔符和换行符。
  • 结果确认前保留原始内容。

下一步可以接着做

这些入口会把当前任务接到更完整的工具链里。

  1. 1 Markdown 转 HTML Markdown 转干净 HTML(标题/列表/代码/链接/图片/表格),实时双栏预览,浏览器本地 打开
  2. 2 Markdown 转 Jira 粘进 GitHub 风格 Markdown,拿到 Jira wiki 标记,标题、粗体、代码块、表格、链接全在浏览器里换好 打开
  3. 3 HTML 转 Markdown HTML 转 Markdown:粘贴富文本,输出干净的 .md,链接 / 代码 / 表格 / 列表全保留。 打开

真实使用场景

  • 把 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,而不是分享网址。

常见问题

类似工具组合

做你这行的人, 还会一起用这些。

Made by Toolora · 100% client-side · Updated 2026-06-14