杂志式长文 HTML
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d6cd2792/ed-rich-ai2html。
技能介绍
问题在哪
办公室里常见场景:一份两千字的 .md 或模型输出的长答,大家很难在碎片时间里真正读完。把 Markdown 机械转成「满屏卡片和盒子」的仪表盘式 HTML,往往更吵、更难读。这个技能的目标是把长文变成单文件、可离线打开的杂志式阅读页——有摘要、有稳定的阅读栏宽,必要时用一张图说清结构,而不是堆组件。
技能如何工作
它只产出一种固定版式(暖象牙底、近黑正文、单一陶土色强调、衬线标题 + 无衬线正文、阅读栏约 680px),样式来自 references/house-style.md,并对照 references/example.html 对齐 Anthropic 式输出。
运行前先区分模式:
- 模式 A:用户给出
.md路径、@引用或粘贴的 Markdown → 同目录、同 basename 输出.html - 模式 B:用户是提问 → 直接生成 HTML,写入当前目录的
answer-{slug}.html
写 HTML 前会先通读全文再定结构,而不是逐条映射 Markdown 元素:
- 用一句话结论填顶部的
.tldr - 拆成 3~7 个
<section>,章节够多时可加粘性目录 - 对流程、架构、量级对比等更适合空间表达的内容,考虑内联 SVG、时间线或
.stats条 - 其余尽量用普通段落;表格、卡片、
.note只在内容确实需要时使用
页面要求自包含:样式内联、不引外链字体/脚本/图;交互优先用原生 <details>,避免无意义的嵌套盒子。
适用边界
- 不适合需要每篇文档换一套视觉品牌或多 accent 色的场景;一致性是设计前提。
- 结构组件有克制上限(例如
.note建议一页最多一两处),滥用卡片/表格会把 prose 读感弄糟。 - 生成后应自检:目录锚点与
id一致、lang与界面文案语言匹配(如 zh-CN 用「目录/概览」),标题衬线字重、单一强调色是否达标。
使用场景
- 内部分享会前,把两千字以上的技术方案 `.md` 转成同目录同名 `.html`,方便同事用浏览器一次读完
- 模型输出的大段 Markdown 复盘稿,需要顶栏 `.tldr`、分节目录和一张架构 SVG 再发给业务方
- 产品/运营提问后,希望答案直接落盘为 `answer-{slug}.html`,而不是再手工套网页模板
- Wiki 或 Confluence 导出的长文,要统一成暖色杂志栏宽、无外链依赖的离线 HTML 附件
适合人员
- 经常把内部规范、复盘写成 Markdown、又要给非工程同事发「能直接打开的一页 HTML」的技术写作者
- 需要把冗长 AI 答复整理成带摘要与少量结构组件(时间线/统计条),而不是满屏卡片的文档维护者
- 按 `references/house-style.md` 批量产出风格一致的 HTML,且不接受每篇文档换一套 UI 的知识库管理员
- 在邮件或 IM 里分发长文说明、希望阅读栏约 680px、自包含无 CDN 的项目负责人