转换rst到markdown总结

一背景知识

一个社区要翻译英文文档（rst格式）到中文，且保存为markdown格式

二 本地在线预览工具VScode编辑器+插件

1 预览markdown插件 markdown-all-in-one

image.png

2 预览ret插件 reStructuredText （注意，记得安装python环境，还有python的rst解析库Sphinx）

image.png

三总结

1 了解了rst如何转换为markdown的工具
2 了解了rst和markdown本地预览工具
3 了解了markdown如何生成导航目录
《1 TOC语法,独立占一行
《2 使用链接格式产生 []()

- [aaaaa章](#aaaaa章)
    - [xxxxxx.a](#xxxxxx.a)
- [bbbb章](#bbbb章)
    - [xxxx.b](#xxxx.b)
  
# aaaaa章
## xxxxxx.a
# bbbb章
## xxxx.b

四 引用

https://cloudconvert.com/rst-to-md 在线rst转markdown格式网站

rst格式是什么

.rst 文件是轻量级标记语言的一种，被设计为容易阅读和编写的纯文本，并且可以借助Docutils这样的程序进行文档处理，也可以转换为HTML或PDF等多种格式，或由Sphinx-Doc这样的程序转换为LaTex、man等更多格式。