WebStorm如何关闭Markdown语法检查功能

在使用WebStorm编写Markdown文档时，许多开发者都遇到过编辑器频繁报错的问题。语法明明正确，但链接、代码块、表格等元素下方却总是出现红色波浪线，严重影响写作体验。

这通常并非你的操作失误。WebStorm默认将Markdown视为一种“结构化代码”进行深度解析，它会严格校验链接目标是否存在、代码块语言是否被支持、表格格式是否精确对齐。对于日常文档撰写而言，这些检查往往过于严苛且不必要。例如，你刚在README.md中添加一个未来才会创建的链接[API文档](./docs/api.md)，或插入一段Mermaid流程图代码，尽管预览正常，编辑器却会提示Unknown language: mermaid。

要彻底解决WebStorm中Markdown的误报问题，核心在于正确关闭几项特定的语法检查功能。

关闭Markdown语法检查的两个核心步骤

有效配置涉及以下两处关键设置，必须全部完成：

• 打开 Settings / Preferences > Languages & Frameworks > Markdown。
• 首先，取消勾选 Enable Markdown code insight。此选项是智能分析的总开关，控制着代码块语言注入、链接验证与自动补全、增强语法高亮等功能。关闭后，大部分红色错误提示将立即消失。
• 随后，在同一页面中找到 Show problems in preview 与 Show problems in editor 选项，一并取消勾选。这两个是“显示开关”，决定IDE是否将检测到的问题以波浪线形式呈现。

请注意操作顺序：Enable Markdown code insight 是问题源头。仅关闭显示开关而不关闭它，问题依然存在只是被隐藏。只有先关闭源头，再关闭显示，才能获得完全洁净的编辑界面。

关闭检查后，为何仍提示“未知语言”？

若按上述步骤操作后，代码块开头的 ```typescript 或 ```mermaid 等标记仍被标红并提示“Unknown language”，这很可能不是语法检查所致。

这是WebStorm的“语言注入”机制在运作。它会尝试识别代码块声明的编程语言，并提供对应的语法高亮和代码提示。如果项目未安装相应语言插件（如TypeScript），或声明了IDE不支持的方言（如Mermaid），便会触发此错误。

解决方案有两种：

• 全局禁用（推荐）：返回 Settings > Languages & Frameworks > Markdown 设置页，找到并取消勾选 Inject language in code fences 选项。这将彻底关闭代码块的语言注入功能。
• 局部抑制：将光标移至报错行，按下 Alt+Enter，在快速修复菜单中选择 Suppress for statement。IDE会自动在该代码块上方添加一行如 的注释，仅抑制此处的警告。

通常建议采用第一种方法，一劳永逸。除非你需要为某些特定代码块（如SQL、JavaScript）保留语法高亮，此时可对个别不支持的语法使用第二种方法进行精准屏蔽。

注意区分：拼写检查与语法检查

许多用户在搜索“关闭Markdown检查”时，容易误操作拼写检查设置，这是一个常见误区。

如果你关闭的是 Settings > Editor > Proofreading 中的选项，那仅会禁用单词拼写错误提示（例如将“variable”误拼为“varialbe”）。这对于 Link is unresolved（链接未解析）、Table cell alignment mismatch（表格对齐错误）等Markdown结构性问题无效。

如何区分？观察波浪线出现的位置及提示内容。若红线出现在链接地址、表格分隔符、列表缩进或标题标记上，且提示信息明确指向Markdown结构问题，则需按前述步骤调整Markdown专属设置。若红线出现在英文单词或中文拼音下方，才是拼写检查。

此外，还存在一些复杂情况。例如在Vue单文件组件的