AI Skill 大全

Markdown 排错与转换

修 Markdown 渲染错乱,并在各解析器之间做格式转换

功能与用途

它的判断核心是:Markdown 对不对不只看文本,还要看谁来渲染。所以列表不嵌套、表格变成竖线、代码块把后面全吃掉、半篇文档变斜体、锚点链接 404、frontmatter 显示成文本、脚注和 Mermaid 在 GitHub 能显示在文档站不行、MDX 报错、README 图片在 npm 上挂掉——这些都能定位到具体是缺空行、缩进跑了、转了没转义字符、目标不支持该扩展、HTML 被过滤这五类原因之一,然后给出该改的确切字符。也能做 Markdown 到 PDF/DOCX/HTML 的双向转换。

适用场景

  • 排查渲染与排版异常:当列表嵌套失效、表格显示为竖线、代码块吞噬后续内容或锚点失效时,准确定位缩进与转义问题并给出修复代码。
  • 跨平台文档格式转换:将 Markdown 导出为 PDF、DOCX 或 HTML,或将网页转回 Markdown,同时适配 GitHub 与 MDX 等不同解析
  • 代码门禁与格式规范修复:解决 markdownlint 或 Prettier 在自动化流水线中的校验报错,调整语法结构,确保 CI 检查顺利通过。

适用人群

  • 维护技术文档和 README 的开发者、写文档站的内容工程师、要在 CI 里跑 markdownlint 或 Prettier 的人

使用步骤

  1. 把出问题的 Markdown 片段和它显示错的效果说清楚,同时说明最终是在哪个平台渲染(GitHub、文档站、Slack 还是导出 PDF)。
  2. 它先判断属于五类毛病里的哪一类,指出具体行和该改的字符,而不是整篇重写。
  3. 要转换格式就说明目标格式,它给出转换参数和该注意的坑,比如导出时会被悄悄丢掉的元素。
  4. 改完后它会记下这个渲染目标的特性,之后处理同一批文档就不用再解释一遍。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
办公
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
简单
版本
1.0.3
最近更新
2026-07-27
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Writes, fixes, and converts Markdown that renders the same in every parser — GitHub, MDX, Pandoc, docs sites, Slack, Notion. Use when a list stops nesting, a table renders as literal pipes, a code fence swallows the rest of the file, half a document turns italic, or an anchor link 404s; when frontmatter shows up as text; when footnotes, task lists, callouts, math, or Mermaid render on GitHub but not on the docs site; when MDX rejects `{`, `<`, or an HTML comment; when a README's images break on npm or PyPI; when converting Markdown to PDF, DOCX, or HTML, or HTML back to Markdown; when markdownlint or Prettier fights the file in CI; when pasting into Slack, Discord, Notion, Confluence, or Jira; and when Markdown from an untrusted source has to be rendered safely. Not for LaTeX documents (`latex`), Word files (`word-docx`), templated PDF deliverables such as reports, invoices, and contracts (`pdf-generator`), or documentation strategy and information architecture (`documentation`).

使用前准备

  • 无

依赖与权限

  • NPM_TOKEN
  • 读取用户主动提供的内容

同类 Skill