VSCode Markdown Preview Enhanced插件TOC功能在MacOS上的配置要点

Markdown Preview Enhanced是VSCode中广受欢迎的Markdown预览插件，其自动生成目录树(TOC)的功能极大提升了文档编写体验。然而部分MacOS用户可能会遇到TOC无法正常显示的问题，本文将深入分析问题原因并提供完整的解决方案。

问题现象分析

当用户在Markdown文档头部配置了toc: true参数时，理论上应该在预览界面左侧显示文档目录结构。但在实际使用中会出现以下情况：

1. Windows系统下TOC功能工作正常
2. MacOS系统下TOC无法显示
3. 即使按照文档说明配置了完整的TOC参数仍无效

核心问题定位

经过技术分析，该问题的根本原因在于VSCode的安全策略限制。Markdown Preview Enhanced生成TOC需要执行JavaScript脚本，而MacOS系统下的VSCode默认禁止插件执行脚本。

完整解决方案

要使TOC功能在MacOS上正常工作，需要进行以下配置：

1. 打开VSCode设置(快捷键Cmd + ,)
2. 搜索markdown-preview-enhanced.enableScriptExecution
3. 勾选该选项或设置为true
4. 重启VSCode使配置生效

进阶配置建议

除了启用脚本执行外，推荐以下优化配置以获得更好的TOC体验：

toc:
  depth_from: 1    # 从一级标题开始
  depth_to: 4      # 显示到四级标题
  ordered: false   # 使用无序列表样式
  float: true      # 浮动目录

工作原理解析

Markdown Preview Enhanced的TOC功能实现机制：

1. 解析Markdown文档的标题结构
2. 生成包含层级关系的DOM树
3. 通过JavaScript动态渲染侧边栏
4. 实现标题点击跳转和自动高亮

在MacOS环境下，第三步的脚本执行被默认阻止，导致整个TOC功能失效。

注意事项

1. 启用脚本执行会带来一定的安全风险，建议仅信任的Markdown文档使用此功能
2. 如果仍遇到问题，可尝试以下步骤：
   • 检查插件是否为最新版本
   • 清除VSCode缓存后重启
   • 重新生成HTML预览文件

通过以上配置和优化，MacOS用户可以获得与Windows系统一致的TOC浏览体验，提升Markdown文档的编写效率。