Markdown

一个确保Markdown在各种解析器中渲染一致的写作、修复与转换工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Markdown。
它的用途是:一个确保Markdown在各种解析器中渲染一致的写作、修复与转换工具。
完整的 Skill 内容见:https://321skill.com/skills/markdown-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请帮我修复这段Markdown,它在Notion里列表嵌套全乱了,而且在Slack里表格显示成了竖线。',它会分析文档结构,修正列表缩进和表格语法,确保其在目标平台正确渲染。或者,你可以说:'把这个README里的Mermaid图转换成能在我们文档站点(使用MDX)安全渲染的格式。',它会处理可能冲突的字符并输出兼容的代码。

介绍

Markdown Skill 旨在解决开发者和内容创作者在不同平台间处理Markdown文档时遇到的渲染不一致问题。例如,在GitHub上显示正常的表格、代码块或数学公式,迁移到其他文档站点或粘贴到Slack、Notion等协作工具时可能出现格式错乱、样式丢失甚至内容被吞掉的情况。该Skill能够智能识别并修复这些跨平台兼容性问题,确保文档在任何地方都能正确呈现。

使用时,你可以将遇到问题的Markdown文档交给它,它会自动诊断并修复嵌套列表中断、表格渲染为纯文本、代码围栏错误、意外斜体、锚链接失效、Frontmatter显示为文本等问题。它还能处理高级语法(如脚注、任务列表、标注、数学公式、Mermaid图表)的兼容性,并安全地转换来自不可信来源的Markdown。

这个Skill非常适合需要频繁编写、维护或迁移技术文档、产品说明、README文件以及需要在多个渠道(如GitHub、内部Wiki、Slack、Confluence)发布内容的开发者、文档工程师和内容运营人员。对于依赖Markdown进行知识管理和团队协作的团队来说,它也是一个提升效率、减少格式调试时间的利器。

建议在将Markdown文档发布到生产环境、粘贴到协作工具前,或从外部来源导入文档时使用此Skill进行“清洁”和标准化。请注意,它主要处理纯Markdown及其扩展语法,对于LaTeX文档、Word文件、需要复杂模板生成的报告/合同PDF,或者文档信息架构规划等任务,建议使用更专门的工具。

核心特点

其核心优势在于专注于解决Markdown的跨解析器渲染一致性问题,能精准处理从基础语法(如列表、表格)到高级扩展(如Mermaid、数学公式)在各种环境(GitHub、MDX、Pandoc、Slack、Notion等)下的兼容性修复,而不仅仅是格式美化或简单转换。

注意事项

不适合处理LaTeX文档、Word文件、基于模板的PDF报告/发票/合同生成,或文档策略与信息架构规划。

常见问题

这个Skill能修复GitHub上正常但其他网站显示错误的Mermaid图表吗?

可以,它专门处理此类跨平台渲染不一致问题,包括Mermaid、数学公式、标注等高级语法。

它能将Markdown转换成PDF或Word吗?

可以,它支持将Markdown转换为PDF、DOCX或HTML,也能将HTML转换回Markdown,并确保转换后的格式正确。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/markdown-x-3/raw/index.md 读取 Markdown 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。