说明书

新潮的「产品」说明书是不为装订而构建，采用网页形式可以用各种前端框架技术，都可以获得非常好的阅览和检索体验。

而传统说明书既要考虑装订，又要考虑 pdf 的浏览体验。通常公司都使用 word 编写，然后导出为 PDF，用来打印装订。

这种方法其实很难把控整体的文档格式，虽然有所谓的模板文档，但是在我的编写体验中，我依然需要频繁地调整格式、使用格式刷、新增页面需要调整页眉页脚。

word 很聪明，他帮你自动处理了很多东西，但有时候他在帮倒忙。我实在不想学习 office 的最佳实践，产品说明书的部分内容却必须研发来编写。

当然，我可以只编写内容，由其他人调整格式。由我调整，或许编写过程慢20分钟，就可以完成，但是别人需要花1个小时慢慢核对，而且容易出错。

我一直在寻找一种，仅需要像 markdown 一样专心编写内容，他就能产生固定格式的工具框架。有很多，但都无法让我满意，或是排版难以考虑装订问题，或是输出的 PDF 没有书签，或是 markdown 方言标签过多。

昨天，或许是看到 quarkdown 发布了新版本，想看看经过两年的发展，他到底能不能满足我的需求。慢慢变成了对各种文档框架进行了彻底挑选和尝试。

最终选定的技术框架是 Pandoc + LaTeX，实际上两年前准备着手进行这件事时，检索下来也是推荐这个技术框架，使用 LaTeX 进行真正的排版吧！但其实我完全不会 LaTeX 方言，两年前 AI 还无法真正构建一个起步项目，现在可以了。

编写体验

在这个框架下，确实可以做到完全只用 markdown 产出内容，不需要理会任何排版相关的事宜。

• 章节会自动编号，以 markdown 标题级别为准。
• 目录会依据章节自动生成，生成依据可调(1~n级标题)。
• 图片会自动编号。
• 生成的 PDF 有良好书签。
• 所有留白尺寸统一调节，装订友好。
• md 接近纯文本，图片分离保存，方便版本管理

一个结果 pdf 的展示

其他功能

作为专业的排版框架，LaTeX 当然也支持 水印、背景 等高级效果，非通用，自行询问 GPT 吧。