技术写作与文档2017texpad.com
Texpad 1.8 公测：集成实时排版的 macOS LaTeX 编辑器
Open Beta of Texpad 1.8, macOS LaTeX editor with integrated realtime typesetting
导读
这是 macOS 上 LaTeX 编辑器 Texpad 1.8 公测版的发布帖，主打内置实时排版。对写作者来说，值得一读的是评论里关于「实时预览到底是帮忙还是干扰」的讨论：即时看到成品很爽，但把写作和排版分开，往往更能保护注意力。
可以直接用的写作要点
- 01
把「写内容」和「调格式」分成两个阶段，别让排版细节打断起草时的心流。
- 02
实时预览是双刃剑：反馈越快越容易分心，可以在初稿阶段关掉预览，定稿前再打开。
- 03
工具是否稳定流畅会直接改变写作节奏，卡顿和等待会消耗写作状态，选工具时值得考虑。
- 04
让源文本更接近最终样子（例如把 \alpha 显示成 α），能降低阅读和校对的认知负担。
HN 评论精选
实时预览容易打断写作心流，把内容与排版分开反而更能专注。
我相信实时渲染在很多场景下都有用。但我当年用 LaTeX 的主要原因之一，正是它让我能把内容创作和操心格式分开：我可以在作者和设计者两种身份之间切换，而不会被跳动的图像或溢出的公式分散我（本就有限的）注意力。事实上我还觉得「编译」LaTeX 文档挺令人兴奋，因为我会期待它最终长什么样。
Toenex查看英文原文
I'm sure real-time rendering will be useful in a variety of use cases. However, one of the main reasons I use LaTeX (when I did) was because it allowed me to separate creation of the content from worrying about the format. This meant I could switch between author and designer without my (feeble) focus being distracted by an image jumping around or an equation overflowing. Indeed I actually found 'compiling' a LaTeX document quite exciting as I anticipated how it might look.
即时反馈和稳定性决定写作节奏，源码可读性也能减轻认知负担。
我下载了公测版试了五分钟。实时排版生效时确实惊艳，比如改动 tikz 图里的坐标，PDF 几乎立刻跟着变；命令和环境的自动补全也很顺滑。但排版器会卡住，我第一次用就碰上了。另外希望有专门的 TeX 编辑器能实现我在 Emacs 里的设置：在编辑区（不是预览区）把 \alpha 显示成 α、\int 显示成 ∫，这个体验太好，以至于我都不敢换编辑器。
cefstat查看英文原文
I've downloaded the beta and played for 5 minutes. First remarks and thoughts: - When the realtime typesetting works it is impressive. For example, changing the coordinates in a tikz picture results in almost immediate change of the PDF. And command / environment auto-completion is very smooth, very well done. - However, the typesetter can get stuck and this happened for me in the first try. I am aware it is only the first public beta so I guess things will improve. - Please, oh please, can any specialized TeX editor reproduce the following feature I have setup in Emacs? In the editor (not live preview) display standard mathematical symbols as symbols and not as commands. For example, make \alpha appear as α or \int appear as ∫. This is so nice that I hesitate moving to other tex editors because I know I will miss it.
同类还值得读
编写更好文档的框架
A Framework for Writing Better Documentation
这是 Divio 的文档写作框架，把技术文档按「读者的目标」分成四类：教程（学习导向）、操作指南（问题导向）、参考（信息导向）、解释（理解导向）。
技术写作与文档2021 · 637 分 · 76 评4 条写作要点编辑精选写好一份设计文档
Writing a good design document
这篇 HN 帖子标题为《Writing a good design document》，主题是如何写好一份设计文档；对写作者来说，它值得作为技术写作和结构化说明文的参照。
技术写作与文档2025 · 581 分 · 147 评3 条写作要点编辑精选技术写作课程
Technical Writing Courses
这是 Google 官方免费技术写作课程（两门），讲受众定义、主动语态、短句、文档结构等基础方法。
技术写作与文档2020 · 571 分 · 73 评4 条写作要点编辑精选写出更好的错误信息
Write better error messages
这篇帖子讨论如何写出更好的错误信息，评论补充了开发者场景下的具体做法和真实反面案例。
技术写作与文档2022 · 566 分 · 253 评4 条写作要点编辑精选写一本技术书的经济账
The Economics of Writing a Technical Book
一位技术书作者拆解写书的真实经济账：版税收入往往远低于投入的时间成本。
技术写作与文档2018 · 519 分 · 149 评4 条写作要点编辑精选