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 的人
使用步骤
- 把出问题的 Markdown 片段和它显示错的效果说清楚,同时说明最终是在哪个平台渲染(GitHub、文档站、Slack 还是导出 PDF)。
- 它先判断属于五类毛病里的哪一类,指出具体行和该改的字符,而不是整篇重写。
- 要转换格式就说明目标格式,它给出转换参数和该注意的坑,比如导出时会被悄悄丢掉的元素。
- 改完后它会记下这个渲染目标的特性,之后处理同一批文档就不用再解释一遍。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 办公
- 适用工具
- 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
- 读取用户主动提供的内容