Markdown语法不生效是因语法错误而非渲染器故障：标题末尾不可有空格，列表项后需加空格，有序列表编号须连续；强调符号须紧贴文字且成对，代码块语言标识须紧贴反引号；链接路径含空格需编码或加引号，特殊字符如#须转义；推荐用markdownlint插件或Markdown Live Preview在线工具快速定位修复。
Markdown 语法不生效时，文档会直接显示原始符号而非预期效果，比如**加粗文字**变成字面的星号、列表项不缩进、标题没变大——这不是渲染器坏了，而是语法本身被破坏了。
检查标题和列表的基础格式
第一步：确认所有标题行末尾没有多余空格或制表符。VSCode 中开启「显示空格」（视图→显示空格）可立刻暴露隐藏干扰符。
第二步：检查列表项后是否跟了空格。错误写法：-item；正确写法：- item。缺少这个空格，解析器会把它当普通段落而非列表项处理。
第三步：有序列表编号必须从 1 开始且连续。若手动写成 1. 第一节 → 3. 第三节，部分解析器（如博客园）会中断自动编号，后续项全部降级为普通文本。
修复加粗、斜体、代码块失效问题
方法一：确保强调符号成对出现且紧贴文字。错误示例：** 加粗 **（星号与文字间有空格）→ 渲染失败；正确应为：**加粗**。
方法二：避免在加粗/斜体内部嵌套其他强调符号。例如 ***最重点*** 在多数平台会被解析为 最重点，但 GitHub 不支持三重嵌套，直接失效。改用 **<em>最重点</em>** 更稳妥。
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
方法三：代码块必须用三个反引号包裹，且语言标识符后不能接空格或换行。错误：``` python\nprint("ok")\n```（python 后多了空格）→ 高亮失效；正确：
print("ok")。【language 标识符与 ``` 必须紧贴】
链接、图片和特殊字符异常处理
链接失效通常因为括号不闭合或路径含空格未编码。例如：[点击](my file.pdf) 应改为：[点击](my%20file.pdf) 或用引号包住：[点击]("my file.pdf")。
图片不显示？先确认文件路径是相对路径且以工作区根目录为基准。VSCode 预览中，./img/logo.png 有效，img/logo.png 可能失败——因为解析器默认从当前文件所在目录向上找，不是从项目根开始。
井号、方括号、星号等出现在正文里却触发了语法？立即转义。比如想写「C# 语法」，必须写成 C\# 语法；否则 # 被识别为标题开头，后面内容全乱。
用工具快速定位并修复语法错误
安装 VSCode 插件 markdownlint，打开 .md 文件后，黄色波浪线会标出所有违规项。按 ⇧⌥F（Mac）或 Ctrl+Shift+I（Win/Linux）可一键自动修复大部分格式问题。
在线校验推荐 Markdown Live Preview：粘贴内容后左侧写、右侧实时渲染，错误位置会高亮提示，比如「Unclosed emphasis」或「Missing blank line before block»」。
命令行用户可运行：markdownlint-cli2-fix README.md。它比人工扫读快十倍，尤其适合批量清理旧文档。注意：该命令会直接覆盖原文件，【操作前务必备份】。
