Markdown 文档转换
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_6dc71712/bau-doc-md-to-html
技能介绍
实际痛点
Markdown 转 HTML 常见的方式是直接渲染 Markdown,结果往往比例失调、没有目录、组件表现力弱。若用于博客教程或内部知识库,缺少结构和视觉约束,长文阅读体验很一般;若希望带品牌风格的配色(例如包豪斯、暖色深色底),需要额外投入不少 CSS 工作,而且还要考虑与IDE 浅色/深色偏好适配。
核心逻辑
这个技能把转换拆成稳定的 HTML 结构与三套主题 CSS 的映射,要求每次使用都先询问用户选用哪套主题,而不是默认选一套。
- 结构化解析:标题映射为不同层级——一级标题
#渲染为 Hero 标题,二级标题##生成侧边目录,三级标题###作为子章节将被纳入锚点。 - 语义分组逻辑:侧边栏按章节内容自动分入
Quick Reference、Core Scenarios、Patterns & Practices、Advanced、Complete Examples、Related。 - 主题一致性:
bauhaus/twin-light/green-manor共享同一套 class,所有新增主题只修改 CSS 变量,确保视觉结构不变。 - 组件化细节:代码块使用
hljs高亮,配色使用统一的nb-red、nb-blue等类名,五色徽章按文档顺序循环避免堆叠。 - 响应式:>1024px 固定侧栏;≤1024px 隐藏侧栏显示
≡按钮,点击展开,文本保持必要留白。
使用边界
- 必须保留原 Markdown 内容,不删减;代码块内的 HTML 符号需转义为
<、>、&。 - 字体、
hljs主题与光标脚本通过 CDN 加载,离线环境可能需要替换为本地资源。 - 输出是自包含 HTML 文件,可直接用浏览器打开,圆角统一不为0,背景/文字规则随主题改变。
使用场景
- 撰写前端技术博客时,需要把一篇带代码块的长文渲染成带侧边目录的独立 HTML
- 维护团队知识库时,希望把教程从 Markdown 一键转换为具有品牌配色的页面
- 为不同主题(包豪斯或深色)输出同一份文档的多版本对比
- 将项目 README 转换为可在浏览器直接打开的 HTML,保留完整目录结构
适合人员
- 前端工程师,需要把技术笔记渲染成可交互的可视化页面
- 开源维护者,希望把 Markdown 文档转换为带导航的品牌化网页
- 技术写作者,需要为文章生成可用于多种视觉主题的 HTML 版本