办公妙招:CHM已死,但离线手册的需求还在

 

1. 办公妙招:CHM已死,但离线手册的需求还在

1.1 引言

CHM曾是技术文档分发的黄金标准,但随着微软停止维护,其在高分屏、安全性等方面的缺陷逐渐暴露。尽管如此,单文件、高压缩、离线搜索等核心需求仍未被满足。

1.2 CHM的辉煌与困境

  1. CHM的优势

    • 单文件分发:便于携带和共享。
    • 高效压缩:适合存储大量文本和图片。
    • 支持动图:适合演示操作步骤。
    • 内置搜索:快速定位内容。
    • 动态交互:支持跳转、目录树等。
  2. CHM的痛点

    • 高分屏适配差:导航栏字体模糊不清。
    • 安全性问题:部分系统默认拦截CHM文件。
    • 生态凋零:微软停止维护,工具链陈旧。

虽然新生代已经很少人知道chm格式,但离线手册市场,chm的这些优点,仍然具有不可替代性,如:AutoHotKey等工具仍坚持使用CHM,但需额外适配高分屏。

1.3 现有替代方案的局限性

  1. HTML+JS手搓离线手册

    • 技术门槛高:需前端开发能力,写作 ➜ 发布之间有巨大技术鸿沟。
    • 维护成本大:每次内容更新需重新生成。
  2. PDF/ePub

    • PDF:静态文本布局效果好,但不支持动图,演示能力存在短板。
    • ePub:支持Gif动图,但缺乏桌面生态,需要安装额外软件且排版效果一言难尽 。
  3. 在线文档

    • 依赖网络:离线场景无法使用。
    • 隐私问题:敏感内容需本地化存储。
  4. 离线站点

    • 使用不便:每次打开文档都要进入目录,找到index.html或某个主页。
    • 维护不便:实际是一堆打包的目录和html文件,丢失个别文件后整个手册就无法阅读。

1.4 单一HTML可能是目前最好的替代chm的方案

  1. 核心功能:完全替代CHM

    • 单文件HTML打包:将所有Markdown章节合并为单一HTML。
    • 导航树与搜索:支持目录跳转和全局搜索。
    • 前后主题跳转:类似CHM的“上一节/下一节”按钮。
  2. 体积优化:WebP压缩

    • 图片体积减少60%-70%,解决HTML文件臃肿问题。
  3. 开箱即用

    • 无需开发:普通用户可直接生成,无需手搓代码。
    • 跨平台兼容:适配Windows/macOS/移动设备。

对比表格:

特性 原生CHM 单一HTML
单文件分发 ✔️ ✔️
内置搜索 ✔️ ✔️
高分屏适配 ❌ ✔️
动态交互 ✔️ ✔️
开发门槛 中等 低

1.5 如何生成带导航栏和搜索栏的单一HTML文件

1.5.1 手册写作部分

  1. 手册的内容来源是Markdown文件,可以使用主流的Markdown编辑工具,如:SoloMD、Typora等(下方主要讲述在SoloMD中的操作过程)。
  2. 手册需要单独的文件夹存放,不要和其他内容混在一起。
  3. 如果手册需要分篇等更高维度的章节管理,可以使用子目录的形式维护,如下图:
  4. 手册中如果包含图片、动图,需要将粘贴格式设置为“WebP”,如下图所示:

📖说明:
有资料说,同样内容的图片,WebP的体积比PNG要小一半甚至更多。(该数据来源为腾讯元宝)


1.5.2 手册导出部分

  1. 在导航树上选中目录节点,如下图所示:

📖说明:
也可以不选中,而在导出窗口手工输入目录。推荐先选中节点,在导出时会自动填写导出源的目录。


  1. 选择菜单“文件 ➜ 导出 ➜ 自定义导出”
  2. 在弹出的导出窗口中设置导出相关参数,如下图所示:
  • 导出范围选择“整个文件夹批量导出”
  • 选择“添加书签栏内容”、“HTML分页载入”

⚠注意:
HTML内容显示宽度,如果设置为0,则页面居左,且铺满页面,而设置指定宽度后,页面内容则居中。


  1. 单击“开始导出”按钮,在窗口底部会显示导出状态,导出完成后即可用浏览器打开查看,如下图所示样例。

1.6 结语

对微软放弃CHM的维护表示极大的遗憾,虽然现在网络发达,在线手册已经占据了很大的份额,PDF手册也非常丰富,但在离线场景下(如信创、保密单位等),这种离线、单一文件、且交互功能多样的格式仍然是刚性需求。
附SoloMD下载地址:SoloMD官网


作者声明:本文用于记录和分享作者的学习心得,可能有部分文字或示例来自AI平台,如:豆包、DeepSeek(硅基流动)(注册链接)等,由于本人水平有限,难免存在表达错误,欢迎留言交流和指教!
Copyright © 2022~2026 All rights reserved.

posted @ 2026-11-20 16:30  tyysoft  阅读(80)  评论(6)    收藏  举报