Markdown
一站式解决Markdown跨平台渲染与格式转换问题
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Markdown。 它的用途是：一站式解决Markdown跨平台渲染与格式转换问题 完整的 Skill 内容见：https://321skill.com/skills/markdown-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的Markdown表格在Slack里显示成了乱糟糟的管道符，帮我把这段内容修复成能在Slack和Notion里都正常显示的格式。’ 它会分析你的表格语法，修正可能导致解析错误的格式，并输出一个兼容性更强的版本。或者，你可以说：‘我需要把这篇Markdown技术文档转换成PDF，并且保持里面的代码高亮和脚注格式。’ 它会处理转换，确保PDF中的样式与原始意图一致。
介绍
这个Skill专门解决Markdown文档在不同平台、解析器或工具间渲染不一致的棘手问题。例如，在GitHub上显示正常的任务列表、数学公式或Mermaid图表，到了你的文档网站可能就变成纯文本；从Notion复制到Slack时格式错乱；或者代码块意外“吞掉”了文档剩余部分。它通过统一的处理引擎，确保你的Markdown内容在GitHub、MDX、Pandoc、Slack、Notion、Confluence、Jira等多种环境下都能正确、安全地呈现。
使用方式非常直接：当你遇到任何Markdown渲染或兼容性问题时，只需将内容交给它。它会自动检测并修复嵌套列表中断、表格显示为管道符、锚链接失效、Frontmatter被当作正文显示、以及MDX因特殊字符（如{、<）而报错等问题。同时，它还能在Markdown、HTML、PDF、DOCX等多种格式间进行高质量转换。
这个Skill非常适合需要频繁编写、维护或分发Markdown文档的各类技术与非技术人员。无论是前端开发者确保README在npm上图片正常显示，文档工程师统一多站点内容格式，内容创作者将文章发布到不同平台，还是产品经理、学术研究者需要生成格式稳定的报告，都能从中受益。
建议在持续集成（CI）流程中集成此Skill，用于自动检查并修复Markdownlint或Prettier的格式冲突。在处理来自不可信来源的Markdown时，使用其安全渲染功能可以避免潜在风险。注意，它主要处理纯Markdown及其衍生格式的兼容性问题，对于复杂的文档生成工作流，可能需要结合其他专用工具。
核心特点
专注于解决Markdown在数十种不同解析器和平台（如GitHub、MDX、Pandoc、Slack、Notion等）间的渲染一致性问题，而非简单的语法高亮或格式美化。其核心能力在于“一次编写，处处正确渲染”，并能安全地处理和转换来自不可信来源的Markdown内容。
注意事项
不适合处理LaTeX文档、Word文件（.docx）、需要复杂模板生成的报告/发票/合同类PDF，也不涉及文档策略或信息架构规划。
常见问题
能修复在GitHub上正常但在我的文档网站上乱掉的Mermaid图表吗？
可以，这是它的核心场景之一，能确保图表等扩展语法在多平台兼容。
能把我的Markdown文章转换成适合公众号排版的HTML吗？
可以，它支持将Markdown转换为HTML，并能处理转换过程中的样式兼容性问题。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-x-4/raw/index.md 读取 Markdown 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-x-4/raw/index.md（查看排版版本）