Markdown 富 HTML 渲染

问题在哪

把 Markdown「导出成 HTML」很容易做成另一份带样式的 .md：标题层级对了，但读者仍要在长文里自己找摘要、决策、待办和风险。报告、面试题集、实施计划、变更日志等文档，结构往往重复出现（对比矩阵、步骤流、Q&A），纯段落渲染并不能减轻扫读成本。

技能如何工作

这是一个 agent-first 技能：目标不是把 # 机械映射成 <h1>，而是先读源文件（单个 .md 或整个文件夹），推断文档的阅读目的，再设计页面信息架构。

典型流程包括：

• 语义块识别：在文档类型之外，识别 executive summary、action items、trade-offs、checklist、代码示例、Mermaid 等局部结构
• 组件选型：用可复用的阅读组件（summary strip、stat grid、callout、comparison table、timeline、step flow、collapsible Q&A 等）替代千篇一律的正文
• 单文件交付：生成带内联 CSS/JS 的自包含 HTML，默认静态校验结构、链接锚点、响应式与基础可访问性
• 按需预览：仅在用户明确要求、或布局/交互/Mermaid/响应式较复杂时，才打开浏览器做视觉检查

设计原则强调首屏暴露真实内容、避免 generic landing page；短而 plain 的笔记则保持克制，不过度装饰。

适用边界

摘要、标签、分类等若出现在页面上，应来自原文或可明确标注为结构标签，不要编造事实。Mermaid 需保留加载或提供可读降级；核心设计决策应留在 agent 推理与组件选择，而非堆叠检测脚本与文档类型模板枚举。