Markdown
一站式解决Markdown跨平台渲染与格式转换问题。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Markdown。 它的用途是：一站式解决Markdown跨平台渲染与格式转换问题。 完整的 Skill 内容见：https://321skill.com/skills/markdown-x-11/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请帮我修复这份README文件，确保它在GitHub和我们的文档网站上看起来一样，并且图片链接在npm上也能正常显示。’，它会分析文档中的列表、表格、代码块、图片链接等，修复所有可能导致跨平台渲染不一致的语法问题。或者，
对AI说：‘帮我把这份Markdown项目报告转换成格式规范的PDF文档。’，它会处理排版、分页等细节，生成可直接交付的PDF文件。
介绍
这个Skill专门解决Markdown文档在不同平台和解析器（如GitHub、MDX、Pandoc、Notion、Slack等）之间渲染不一致或格式错乱的痛点。例如，列表嵌套失效、表格显示为纯文本、代码块吞掉后续内容、文档部分内容意外变为斜体、锚链接失效、Frontmatter被当作正文显示，以及脚注、任务列表、数学公式、Mermaid图表等扩展语法在某些平台无法正确渲染。
使用时，你可以将遇到问题的Markdown文档交给它，它会自动诊断并修复兼容性问题，确保文档在任何地方都能正确显示。此外，它还支持在Markdown、HTML、PDF、DOCX等多种格式之间进行高质量转换，并能安全地渲染来自不受信任来源的Markdown内容。
该Skill非常适合需要编写、维护或分发跨平台技术文档、产品说明、README文件、内部Wiki或任何需要在多个渠道保持格式一致的内容创作者和开发者。对于需要在CI/CD流程中统一Markdown格式，或需要将内容粘贴到Slack、Confluence、Jira等协作工具中的团队尤其有用。
建议在处理任何可能涉及多平台分发的Markdown文档时优先使用此Skill进行格式检查和修复。注意，它主要处理纯Markdown及其常见扩展语法，对于复杂的LaTeX文档、Word文件、需要模板生成的报告/合同类PDF，或文档策略规划等任务，应使用其他专门Skill。
核心特点
与单一功能的Markdown工具不同，它专注于解决跨解析器渲染一致性的核心痛点，能一次性处理从语法修复、安全渲染到多格式转换的全链路问题，尤其擅长处理GitHub Flavored Markdown (GFM) 与各类文档站点、协作工具之间的兼容性差异。
注意事项
不适合处理LaTeX文档、Word文件、需要复杂模板生成的报告/发票/合同类PDF，或进行文档策略与信息架构规划。
常见问题
能修复在GitHub上显示正常但在我的文档网站上乱掉的Markdown吗？
可以，这正是它的核心功能之一，能自动调整语法以确保在GitHub、MDX、Pandoc及各类文档站点上渲染一致。
能把我的Markdown转换成漂亮的PDF或Word文档吗？
可以，它支持将Markdown高质量地转换为PDF、DOCX或HTML，也支持将HTML转换回Markdown。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-x-11/raw/index.md 读取 Markdown 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-x-11/raw/index.md（查看排版版本）