Markdown

核心用法

本Skill是一份Markdown跨解析器兼容性指南，聚焦实际编写中导致渲染差异的陷阱与解决方案。核心围绕六大模块展开：

1. Whitespace Traps（空白符陷阱）：强调列表、代码块、引用块前必须空行；嵌套列表需4空格而非2空格；避免用双空格换行；清理行尾空格。
2. Links & Images（链接与图片）：处理URL中的括号和空格（使用百分号编码或尖括号包裹）；提醒引用式链接可能静默失败；强制要求图片alt文本。
3. Code（代码）：解决反引号嵌套问题（4+反引号外层围栏或双反引号包裹）；语言标识对语法高亮的影响。
4. Tables（表格）：列对齐语法（---:, :---, :---:）；管道符转义；禁止表格前空行；空单元格占位。
5. Escaping（转义）：列出文本中需转义的特殊字符；代码区域内无需转义。
6. Portability（可移植性）：优先纯Markdown而非HTML；扩展语法（脚注、任务列表等）需确认目标解析器支持；YAML frontmatter的放置规范。

显著优点

• 问题驱动：每个要点对应真实渲染故障案例，实用性强
• 覆盖主流解析器：兼顾GitHub Flavored Markdown与CommonMark严格实现
• 细节精确：如4空格vs2空格、双空格换行被编辑器剥离等，减少调试成本

潜在缺点/局限性

• 非完整教程：假设用户已了解Markdown基础，仅聚焦"坑点"
• 无自动化检测：纯文档型Skill，无工具辅助验证
• 扩展语法覆盖有限：未深入Mermaid、数学公式等现代扩展
• 版本漂移风险：解析器行为可能更新，建议需定期校验

适合人群

• 技术文档工程师、开源项目维护者、需要确保README/文档在多平台（GitHub/GitLab/静态站点生成器）一致渲染的开发者。

常规风险

• 内容本身为规范文档，无执行风险；但若用户依赖其中建议而目标解析器未明确遵循CommonMark，仍可能出现预期外渲染差异。

核心用法

Markdown Skill 是一份详尽的 Markdown 语法规范参考文档，涵盖六大关键领域：空白符处理、链接与图片、代码块、表格、转义字符及跨平台兼容性。文档针对常见陷阱提供了具体解决方案——如嵌套列表需 4 空格而非 2 空格、URL 中的括号需转义、代码块内外层反引号冲突处理等。

显著优点

极致安全性：纯静态文档，无可执行代码、无外部依赖、无网络调用，获得 S+ 安全评级和满分 100 分认证。高度实用性：内容聚焦真实写作痛点，如 GitHub 与 CommonMark 的解析差异、HTML 标签的兼容性问题等，对技术写作者极具参考价值。轻量便携：49 行内容覆盖核心场景，即查即用。

潜在缺点与局限性

来源可信度受限：维护者为匿名标识符（kn73vp5rarc3b14rc7wjcw8f8580t5d1），属 T3 级别（个人开发者/社区项目），无企业背书。功能单一：仅提供规范参考，无交互式校验、实时预览或自动化格式化功能。版本覆盖有限：未明确标注支持的 Markdown 方言版本（如 CommonMark 0.31、GitHub Flavored Markdown 等具体规范）。

适合人群

• 技术文档工程师、开发者、内容创作者
• 需要确保 Markdown 在 GitHub/GitLab/Jekyll 等多平台正确渲染的用户
• 对安全性要求极高、希望完全隔离代码执行风险的保守型用户

常规风险

风险极低。主要注意事项：内容更新依赖社区维护，建议升级前审查变更差异；规范建议需结合目标平台的实际解析器行为验证。