别着急,坐和放宽
新潮的⌈产品⌋说明书是不为装订而构建,采用网页形式可以用各种前端框架技术,都可以获得非常好的阅览和检索体验。
而传统说明书既要考虑装订,又要考虑 pdf 的浏览体验。通常公司都使用 word 编写,然后导出为 PDF,用来打印装订。
这种方法其实很难把控整体的文档格式,虽然有所谓的模板文档,但是在我的编写体验中,我依然需要频繁地调整格式、使用格式刷、新增页面需要调整页眉页脚。
word 很聪明,他帮你自动处理了很多东西,但有时候他在帮倒忙。我实在不想学习 office 的最佳实践,产品说明书的部分内容却必须研发来编写。
当然,我可以只编写内容,由其他人调整格式。由我调整,或许编写过程慢20分钟,就可以完成,但是别人需要花1个小时慢慢核对,而且容易出错。
我一直在寻找一种,仅需要像 markdown 一样专心编写内容,他就能产生固定格式的工具框架。有很多,但都无法让我满意,或是排版难以考虑装订问题,或是输出的 PDF 没有书签,或是 markdown 方言标签过多。
昨天,或许是看到 quarkdown 发布了新版本,想看看经过两年的发展,他到底能不能满足我的需求。慢慢变成了对各种文档框架进行了彻底挑选和尝试。
最终选定的技术框架是 Pandoc + LaTeX,实际上两年前准备着手进行这件事时,检索下来也是推荐这个技术框架,使用 LaTeX 进行真正的排版吧!但其实我完全不会 LaTeX 方言,两年前 AI 还无法真正构建一个起步项目,现在可以了。
在这个框架下,确实可以做到完全只用 markdown 产出内容,不需要理会任何排版相关的事宜。

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