Markdown
一站式解决Markdown跨平台渲染与格式转换问题
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Markdown。 它的用途是：一站式解决Markdown跨平台渲染与格式转换问题 完整的 Skill 内容见：https://321skill.com/skills/markdown-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把这篇包含复杂表格和脚注的Markdown技术文档，转换成在GitHub、我们的文档站点和Confluence上都能完美渲染的版本，并检查所有内部链接。’，它会分析文档结构，识别并修复可能导致各平台渲染差异的语法，生成一份兼容性极强的标准化文档，并报告链接状态。
介绍
Markdown Skill 专门解决因不同解析器（如GitHub、MDX、Pandoc、Notion、Slack等）标准差异导致的文档渲染不一致问题。当你的列表嵌套失效、表格显示为原始管道符、代码块吞掉后续内容、文档部分内容意外变为斜体、锚链接404、Frontmatter被当作纯文本显示，或在GitHub上能正常渲染的脚注、任务列表、数学公式、Mermaid图在文档网站上失效时，这个Skill能帮你快速定位并修复。
它通过智能分析和转换Markdown语法，确保文档在所有目标平台上都能获得一致的渲染效果。你可以用它来修复格式错误，也可以在不同格式（如PDF、DOCX、HTML）间进行转换，甚至安全地渲染来自不受信任来源的Markdown内容。
该Skill非常适合需要频繁编写、维护或分发Markdown文档的开发者、技术写作者、内容创作者和项目经理。无论是为开源项目维护README，编写技术文档，还是在不同协作平台（如Confluence、Jira）间粘贴内容，都能显著提升效率和质量。
使用建议：在处理复杂文档（如包含数学公式或Mermaid图）前，建议先备份原文件。对于LaTeX文档、Word文件、需要模板生成的报告/合同类PDF，或涉及文档策略和信息架构的宏观问题，请使用其他专用Skill。
核心特点
与仅提供基础格式转换的工具不同，此Skill深度集成了对GitHub Flavored Markdown (GFM)、MDX、Pandoc等多种方言和扩展语法的理解，能精准修复因解析器差异导致的特定渲染问题，如代码块吞噬、Frontmatter显示异常等，而非简单的语法转换。
注意事项
不适合处理LaTeX文档、Word文件、需要模板生成的报告/发票/合同类PDF，或文档策略与信息架构等宏观规划问题。
常见问题
能修复在GitHub上正常但在我的文档网站上显示混乱的Mermaid图表吗？
可以，它能识别并转换特定平台的Mermaid语法，确保图表跨平台一致渲染。
能把我的Markdown文档转换成适合Slack或Notion的格式吗？
可以，它能针对Slack、Notion等平台的解析特性进行格式优化，确保粘贴后样式正确。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-x/raw/index.md 读取 Markdown 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-x/raw/index.md（查看排版版本）