技术写作与文档2011markdownpad.com
终于有了 Windows 上的 Markdown 编辑器
Finally, a Markdown editor for Windows
导读
这篇帖子介绍 Windows 上的 Markdown 编辑器 MarkdownPad，评论区围绕“是否真的需要专门的 Markdown 编辑器”展开讨论。对写作者的价值在于提醒：Markdown 的核心是把内容与版式分开，写作时先别被排版分心，发布前再做少量表面调整。
可以直接用的写作要点
- 01
写作时先专注内容表达，把字体、间距、版式等决定留到发布前统一处理。
- 02
Markdown 的意义在于减少边写边调格式的干扰，而不是增加一套需要时时操心的排版工具。
- 03
发布前的排版修正应控制在少量表面调整，避免反复打磨版式拖慢交付。
- 04
选择写作工具时，优先看它是否帮你保持内容优先的工作流，而不是功能多少。
HN 评论精选
质疑 Markdown 编辑器的必要性，强调 Markdown 应让作者专注内容、把排版推迟到发布。
我一直不太理解这类编辑器的意义。Markdown 的全部意义不就是让你在发布前不用考虑排版吗？（到发布时做少量表面修补就完事了。）
skrebbel查看英文原文
I never really understood the point of these editors. Isn't the whole point of Markdown that you don't need to think about layout until you publish it? (which is when you make a small number of superficial fixes and that's 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 条写作要点编辑精选