Agent Skills
返回列表
Markdown 文档转换

Markdown 文档转换

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 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 版本