Markdown

核心用法

该技能提供 Markdown 编写规范指南，覆盖从基础语法到高级排版的完整知识体系。主要功能模块包括：

• Whitespace 陷阱规避：明确空行前置规则、嵌套列表缩进标准（4 空格）、避免隐形换行符
• 链接与图片处理：URL 特殊字符编码方案、引用式链接验证机制、无障碍 alt 文本强制要求
• 代码块书写：嵌套反引号转义技巧、语言标识符最佳实践
• 表格语法：对齐标记规范、管道符转义、空白单元格处理
• 字符转义清单：明确 8 类必须转义的特殊字符
• 跨平台兼容性：HTML 标签降级策略、扩展语法风险提示、YAML frontmatter 限制

显著优点

1. 系统性覆盖：从空格到表格，构建 Markdown 问题的完整知识图谱
2. 场景化警示：每条规则附带具体失败案例（如 "2 空格破坏严格解析器嵌套"）
3. 工具链友好：特别针对 GitHub/CommonMark 等主流解析器优化
4. 可执行性强：提供明确的替代方案（如 %28 替代括号、4 空格替代 2 空格）

潜在局限

• 静态文档属性：仅为参考指南，无自动化检测或修复工具
• 目标平台锁定：部分规则（4 空格缩进）针对特定解析器，非普适标准
• 更新依赖：Markdown 方言演进（如 GitHub Flavored Markdown 更新）可能使部分建议过时
• 无交互验证：不提供实时预览或错误高亮功能

适合人群

• 技术文档写作者、开源项目维护者
• 需要将内容发布至多平台（GitHub、GitBook、静态站点等）的开发者
• 遭遇 Markdown 渲染不一致问题的用户
• 追求文档可访问性（alt 文本规范）的内容创作者

常规风险

• 过度转义：不当使用 \ 可能导致预期外文本显示
• 编码遗忘：URL 手动编码易遗漏，建议配合 URL 编码工具
• 表格可读性：复杂表格维护困难，建议拆分为简单表格或改用代码块
• 扩展语法滥用：脚注、任务列表等语法在目标平台不支持时将直接暴露源码

核心用法

该 Skill 是一份详尽的 Markdown 格式规范指南，旨在帮助用户生成跨平台兼容、渲染稳定的 Markdown 文档。内容涵盖六大核心模块：

1. Whitespace Traps（空白陷阱）：强调列表、代码块、引用前必须空行；嵌套列表需 4 空格缩进；避免依赖双空格换行等
2. Links & Images（链接与图片）：URL 特殊字符编码规范、引用式链接验证、图片 alt 文本无障碍要求
3. Code（代码块）：嵌套反引号处理、语言标注语法高亮建议
4. Tables（表格）：对齐语法、管道符转义、空单元格处理
5. Escaping（转义）：特殊字符转义清单
6. Portability（可移植性）：HTML 标签慎用、扩展语法兼容性提醒、YAML frontmatter 规范

显著优点

• 零安全风险：纯静态文档，无任何可执行代码、网络请求或依赖
• 实用性强：覆盖 GitHub、CommonMark 等主流解析器的兼容性差异
• 细节丰富：提供具体数值（如 4 空格、百分号编码）而非模糊建议
• 无障碍友好：强调图片 alt 文本的必填性

潜在局限

• 无交互功能：仅为参考文档，无法自动格式化或校验 Markdown
• 扩展语法覆盖有限：未深入 Mermaid、MathJax 等高级扩展
• 无实时示例：缺少 side-by-side 源码与渲染效果对比

适合人群

• 技术文档写作者、开源项目维护者、博客作者、需要确保 Markdown 跨平台兼容性的开发者

常规风险

极低风险。该 Skill 为纯文本知识库，不涉及代码执行、数据收集或外部通信。用户仅需注意：若未来版本更新引入脚本功能，需重新评估安全性。