如何在VSCode中通过lextudio.restructuredtext扩展结合Myst-parser实现MyST风格Markdown文件的Sphinx构建实时预览

我之前也踩过类似的坑，折腾了一阵终于解决了，给你一步步梳理配置方法：

1. 让lextudio.restructuredtext扩展识别MyST Markdown文件 #

默认这个扩展只处理.rst格式文件，首先得让它把.md也纳入处理范围：

• 打开VSCode设置（快捷键Ctrl+,），搜索restructuredtext.documentPatterns
• 点击「编辑 in settings.json」，添加.md的匹配规则：

"restructuredtext.documentPatterns": [
    "**/*.rst",
    "**/*.md"
]

2. 指定Sphinx配置文件的路径 #

扩展需要知道你的conf.py位置才能正确调用Sphinx构建：

• 同样在设置里搜索restructuredtext.confPath
• 设置为你的conf.py所在文件夹的绝对路径，比如你的配置文件在项目根目录的docs/source下，就填：

"restructuredtext.confPath": "${workspaceFolder}/docs/source"

记得替换成你自己项目的实际路径，确保指向包含conf.py的文件夹。

3. 切换到Restructured Text预览模式 #

打开MyST Markdown文件后，VSCode默认会触发自带的Markdown预览，这时候需要手动切换：

• 点击右上角预览按钮旁边的下拉箭头
• 选择Restructured Text Preview，这样就会调用lextudio的扩展基于Sphinx构建预览内容

4. 确认Myst-parser已正确加载 #

虽然你说conf.py配置无误，但还是再核对一下：确保extensions列表里已经加入了myst_parser：

extensions = [
    # 你的其他扩展...
    'myst_parser',
]

这是Sphinx能解析MyST语法的核心前提。

5. 重启VSCode让配置生效 #

改完所有设置后，一定要重启VSCode，不然新的配置可能不会被加载。

额外提示：仅预览当前文件 #

这个扩展默认支持基于单个文件构建预览，正好符合你“只看正在编辑的文件”的需求。如果遇到预览仍加载整个站点的情况，可以检查开启单文件构建设置：

"restructuredtext.buildSingleFile": true

如果还是有问题，可以打开VSCode的输出面板（Ctrl+Shift+U），切换到「Restructured Text」频道查看报错信息，比如路径错误、依赖缺失等，根据提示调整即可。

内容的提问来源于stack exchange，提问作者Mathias Rime