Markdown
统一处理与修复跨平台Markdown文档的渲染问题。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Markdown。 它的用途是：统一处理与修复跨平台Markdown文档的渲染问题。 完整的 Skill 内容见：https://321skill.com/skills/markdown-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的README.md在GitHub上显示正常，但用docsify搭建的文档站点里，任务列表没有变成复选框，数学公式也显示为代码。请帮我修复这份Markdown，让它在这两个地方看起来一致。’ 它会分析文档中GitHub特有的语法（如任务列表`- [x]`）和可能冲突的数学公式语法，将其转换为兼容性更强的形式，或提供安全的替代方案，确保双平台渲染一致。
介绍
Markdown Skill 专门解决因不同解析器（如GitHub、MDX、Pandoc、Notion、Slack等）语法支持差异导致的文档渲染不一致问题。例如，列表嵌套中断、表格显示为原始管道符、代码块吞掉后续内容、文档部分内容意外变为斜体、锚链接失效、Frontmatter被当作普通文本显示，以及脚注、任务列表、数学公式、Mermaid图表等扩展语法在某些平台无法正确渲染。
使用时，你可以将存在问题的Markdown文档内容或片段交给它，它会分析并生成一个能在所有目标平台上保持渲染一致性的“统一”版本。它还能安全地处理来自不可信来源的Markdown，并支持在Markdown与PDF、DOCX、HTML等格式之间进行转换。
该Skill非常适合需要编写、维护或迁移技术文档、README、项目说明、以及需要在多个协作平台（如GitHub、公司文档站、Slack、Confluence）之间同步内容的开发者、文档工程师和内容创作者。对于产品经理和运营人员，在准备跨平台发布的营销或产品材料时也能提供帮助。
建议在文档发布前、CI/CD流程中遇到markdownlint或Prettier冲突时，或从外部粘贴富文本到Markdown编辑器后使用此Skill进行标准化处理。注意，它并非一个通用的文档生成或内容策略工具，其核心是解决渲染一致性问题。
核心特点
与通用文本处理工具不同，它深度理解各主流Markdown解析器（GitHub Flavored Markdown, MDX, CommonMark等）的语法差异与兼容性陷阱，能主动修复因解析器差异导致的渲染错误，而非简单格式化。同时，它专注于生成“一次编写，处处渲染一致”的Markdown，并内置了对不安全HTML/JS的过滤，确保跨平台渲染的安全性。
注意事项
不适合处理LaTeX专业文档、Word文件（.docx）、需要复杂模板的报告/合同PDF生成，或进行文档信息架构设计。
常见问题
能修复GitHub上显示正常但在我本地文档网站显示异常的Mermaid图表吗？
可以，它能识别并转换图表语法，确保在支持CommonMark但不原生支持Mermaid的解析器中也能通过兼容方式显示或安全降级。
将网页HTML粘贴到Notion时格式混乱，这个Skill能处理吗？
能，它可以将HTML内容转换并清理为纯净、跨平台兼容的Markdown，确保在Notion、Slack等平台正确渲染。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-x-2/raw/index.md 读取 Markdown 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-x-2/raw/index.md（查看排版版本）