Show HN: Inkling – 让 Claude Code 写文档，得到的是 HTML 而不是 Markdown

一句话看懂：一个名为 Inkling 的开源 Claude Code 技能，让开发者用自然语言直接生成可交互的 HTML 文档文件夹，而不是传统的 Markdown 文件，目标是让设计文档、系统架构图这类”重表达”内容真正动起来。

事件核心：发生了什么

Inkling 由 GitHub 用户 MeetVys 发布在 Hacker News 的 Show HN 板块，定位是 Claude Code 的一个技能（skill）。安装方式很简单：让 Claude Code 从指定仓库抓取 SKILL.md 并写入 ~/.claude/skills/inkling/SKILL.md，或用一条 curl 命令完成。安装后，Claude Code 会识别用户是否在构建”思考型文档”——愿景文档、HLD、LLD、学习笔记、性能报告等，并自动路由到这个技能。

它不是把 Markdown 转换成 HTML，而是在磁盘上直接生成并逐轮编辑一个真实文档文件夹，包含 index.html、style.css、runtime.js、data/* 等文件。用户说”创建一个关于 X 的 HTML 文档”，Agent 就会设计版式、发明交互结构、编辑实时文件夹，并把每次改动记录进追加式事件日志。文档按五个维度自审：交互性、计算性、美观度、温度感和原创性，原创性低于 5/10 视为不通过。

为什么重要

这触及了一个常被忽视的问题：并非所有文档都以文字为主。系统设计图、漏斗转化图、可点击的流程演示，用 Markdown 表达天然受限。过去手写一套交互式 SVG 加样式表的成本太高，没人会为一份内部设计文档投入这些工时。随着 Claude Code 这类 Agent 在 HTML、CSS、JavaScript 上的生成能力变强，这部分成本被显著压低。Inkling 的思路是把”文档”从单一 Markdown 文件升级为自包含、无服务器、可直接在浏览器打开的文件夹，同时保留归档永久性——渲染产物在生成时冻结，套件更新只向前生效，旧文档不受影响。目前公开信息显示，这与 Cursor、Windsurf 等工具在”代码即文档”方向上的探索形成互补，而非直接竞争。

对用户/开发者/创作者的影响

对经常写技术文档和系统设计的人，这是一种值得关注的替代路径：文档不再需要编译或依赖外部服务，直接用浏览器打开即可分享。对 Claude Code 用户而言，这展示了 skill 机制的扩展方式——依靠 Bash、Read、Write 三个默认工具就能完成安装，不需要额外的 MCP server 或插件授权。对创作者来说，可交互图表和计算型组件让内容表现力更强，但也意味着文档的维护对象从文字变成了代码文件夹，需要适应 Agent 逐轮编辑的工作流。