办公妙招:CHM已死,但离线手册的需求还在
1. 办公妙招:CHM已死,但离线手册的需求还在
1.1 引言
CHM曾是技术文档分发的黄金标准,但随着微软停止维护,其在高分屏、安全性等方面的缺陷逐渐暴露。尽管如此,单文件、高压缩、离线搜索等核心需求仍未被满足。
1.2 CHM的辉煌与困境
-
CHM的优势
- 单文件分发:便于携带和共享。
- 高效压缩:适合存储大量文本和图片。
- 支持动图:适合演示操作步骤。
- 内置搜索:快速定位内容。
- 动态交互:支持跳转、目录树等。
-
CHM的痛点
- 高分屏适配差:导航栏字体模糊不清。
- 安全性问题:部分系统默认拦截CHM文件。
- 生态凋零:微软停止维护,工具链陈旧。
虽然新生代已经很少人知道chm格式,但离线手册市场,chm的这些优点,仍然具有不可替代性,如:AutoHotKey等工具仍坚持使用CHM,但需额外适配高分屏。
1.3 现有替代方案的局限性
-
HTML+JS手搓离线手册
- 技术门槛高:需前端开发能力,写作 ➜ 发布之间有巨大技术鸿沟。
- 维护成本大:每次内容更新需重新生成。
-
PDF/ePub
- PDF:静态文本布局效果好,但不支持动图,演示能力存在短板。
- ePub:支持Gif动图,但缺乏桌面生态,需要安装额外软件且排版效果一言难尽 。
-
在线文档
- 依赖网络:离线场景无法使用。
- 隐私问题:敏感内容需本地化存储。
-
离线站点
- 使用不便:每次打开文档都要进入目录,找到index.html或某个主页。
- 维护不便:实际是一堆打包的目录和html文件,丢失个别文件后整个手册就无法阅读。
1.4 单一HTML可能是目前最好的替代chm的方案
-
核心功能:完全替代CHM
- 单文件HTML打包:将所有Markdown章节合并为单一HTML。
- 导航树与搜索:支持目录跳转和全局搜索。
- 前后主题跳转:类似CHM的“上一节/下一节”按钮。
-
体积优化:WebP压缩
- 图片体积减少60%-70%,解决HTML文件臃肿问题。
-
开箱即用
- 无需开发:普通用户可直接生成,无需手搓代码。
- 跨平台兼容:适配Windows/macOS/移动设备。
对比表格:
| 特性 | 原生CHM | 单一HTML |
|---|---|---|
| 单文件分发 | ✔️ | ✔️ |
| 内置搜索 | ✔️ | ✔️ |
| 高分屏适配 | ❌ | ✔️ |
| 动态交互 | ✔️ | ✔️ |
| 开发门槛 | 中等 | 低 |
1.5 如何生成带导航栏和搜索栏的单一HTML文件
1.5.1 手册写作部分
- 手册的内容来源是Markdown文件,可以使用主流的Markdown编辑工具,如:SoloMD、Typora等(下方主要讲述在SoloMD中的操作过程)。
- 手册需要单独的文件夹存放,不要和其他内容混在一起。
- 如果手册需要分篇等更高维度的章节管理,可以使用子目录的形式维护,如下图:

- 手册中如果包含图片、动图,需要将粘贴格式设置为“WebP”,如下图所示:

📖说明:
有资料说,同样内容的图片,WebP的体积比PNG要小一半甚至更多。(该数据来源为腾讯元宝)
1.5.2 手册导出部分
- 在导航树上选中目录节点,如下图所示:

📖说明:
也可以不选中,而在导出窗口手工输入目录。推荐先选中节点,在导出时会自动填写导出源的目录。
- 选择菜单“文件 ➜ 导出 ➜ 自定义导出”
- 在弹出的导出窗口中设置导出相关参数,如下图所示:

- 导出范围选择“整个文件夹批量导出”
- 选择“添加书签栏内容”、“HTML分页载入”
⚠注意:
HTML内容显示宽度,如果设置为0,则页面居左,且铺满页面,而设置指定宽度后,页面内容则居中。
- 单击“开始导出”按钮,在窗口底部会显示导出状态,导出完成后即可用浏览器打开查看,如下图所示样例。

1.6 结语
对微软放弃CHM的维护表示极大的遗憾,虽然现在网络发达,在线手册已经占据了很大的份额,PDF手册也非常丰富,但在离线场景下(如信创、保密单位等),这种离线、单一文件、且交互功能多样的格式仍然是刚性需求。
附SoloMD下载地址:SoloMD官网
作者声明:本文用于记录和分享作者的学习心得,可能有部分文字或示例来自AI平台,如:豆包、DeepSeek(硅基流动)(注册链接)等,由于本人水平有限,难免存在表达错误,欢迎留言交流和指教!
Copyright © 2022~2026 All rights reserved.

浙公网安备 33010602011771号