今天要给大家强烈安利一个超级实用的 GitHub 仓库——markdown-viewer/skills。响马老师的大作!
这个仓库专为 AI 编码代理(AI Coding Agents)设计,提供了一套意见化的 Skills,让 Claude、Cursor、GitHub Copilot 等 AI 工具能够直接在 Markdown 中生成专业级别的图表、架构图、数据可视化和信息卡片,效果惊艳,堪比专业设计工具!
为什么这个仓库值得关注?
传统写技术文档时,画流程图、架构图、UML 往往需要切换到 Visio、Draw.io、Lucidchart 等工具,费时费力,还不好嵌入 Markdown。
现在,有了 markdown-viewer/skills,你只需告诉 AI:“帮我画一个微服务架构图”,AI 就能自动调用对应的 Skill,生成高质量、可直接渲染的 Markdown 图表内容。
仓库目前包含 15 个 Skills,覆盖 7 种渲染引擎,从简单流程图到企业级架构、数据分析、IoT 全都有!
核心 Skills 一览(超实用分类)
1. 独立 Skills(最常用)
- • Mermaid:流程图、序列图、状态机、甘特图等 14+ 类型,语法简单,适合过程流、API 交互。
- • Vega:数据驱动图表(柱状图、折线图、散点图、热力图、雷达图、词云),专业数据可视化首选。
- • Infographic:70+ 预设模板,KPI 卡片、时间线、SWOT 分析、漏斗图、组织架构树,快速做出报告级效果。
- • Canvas:空间节点图、思维导图、知识图谱、规划板。
- • Graphviz:复杂依赖图、调用图、模块关系。
2. HTML/CSS 嵌入式 Skills(直接出杂志级效果)
- • Architecture:13 种布局 × 12 种样式,分层架构图、微服务架构,颜色编码清晰。
- • Infocard:13 种布局 × 14 种样式,信息卡片、知识总结、数据高亮、活动公告,排版优雅。
3. PlantUML 系列(企业级重度用户必备)
- • UML:14 种 UML 图 + 9500+ 图标。
- • Cloud:AWS、Azure、GCP、Kubernetes 等云架构图标。
- • Network:网络拓扑、Cisco 等设备图标。
- • Security:威胁模型、零信任架构。
- • ArchiMate:企业架构分层建模。
- • BPMN:业务流程、集成模式。
- • Data Analytics:ETL 管道、数据仓库、ML 工作流。
- • IoT:传感器、网络、边缘计算、数字孪生。
仓库还提供了详细的技能选择指南,根据不同场景(如流程图、架构、数据可视化、安全模型等)推荐最佳 Skill,超级贴心。
如何快速上手?
最推荐方式(一键安装):
npx skills add markdown-viewer/skills
支持 Claude Code、Cursor 等多个 AI 工具。
其他方式:
- • 手动复制 Skills 文件夹到对应目录。
- • 在项目
.github/skills/下放置,GitHub Copilot 会自动识别。
- • 直接把 SKILL.md 内容贴给 AI 使用。
每个 Skill 都遵循 Agent Skills 标准格式,包含清晰的使用说明、示例和最佳实践,AI 能精准理解并生成。
实际应用场景
- • 开发者:快速画 UML 类图、序列图、微服务架构。
- • 架构师:企业级 ArchiMate、云架构、零信任安全模型。
- • 数据分析师:Vega 数据图表 + Infographic KPI 仪表盘。
- • 产品/运营:思维导图、时间线、SWOT、活动信息卡。
- • 技术文档作者:Markdown 一体化,文档美观、专业、可版本控制。
生成后的图表可以直接在支持 Mermaid、PlantUML 等渲染的平台(GitHub、Typora、微信公众号 Markdown 编辑器、Notion 等)完美显示。
AI 时代的技术文档新范式
markdown-viewer/skills 真正让 AI 从“帮你写代码”进化到“帮你可视化思考”。它降低了绘制专业图表的门槛,让技术沟通更高效、更美观。
仓库:https://github.com/markdown-viewer/skills
如果你是 AI 工具重度用户、架构师、文档工程师,或者正在写技术博客、产品 PRD、架构设计文档,这个 Skills 集合绝对能大幅提升你的生产力!