写作方法2013criticmarkup.com
Critic Markup：面向人类的纯文本批注标记
Critic Markup: Plain-Text Editing Markup for Humans
导读
Critic Markup 是一套用纯文本符号标注增删改与批注的编辑标记法，让作者和编辑不必依赖 Word 修订模式，也能在任何文本编辑器里协作改稿。讨论里有人叫好并动手做插件，也有人泼冷水：标记一多就会淹没正文，不如直接用 diff。对写作者而言，它真正值得读的地方是“改稿痕迹该怎么呈现、怎么和定稿分开”这一工作流问题。
可以直接用的写作要点
- 01
把修改痕迹和最终定稿分开：先看带标记的版本做取舍，再输出一份干净的正文，别让读者在满屏标记里读文章。
- 02
标记法要尽量轻量、易记，否则协作者不愿用；评论里提到的括号记法就是更简的替代思路。
- 03
自造一套标记之前，先看看 diff 这类现成工具，能省掉学习和兼容的成本。
- 04
纯文本标记的好处是能直接进版本控制、用 diff 比较、在任何编辑器里打开，适合长期维护的文稿。
HN 评论精选
标记一多就会淹没正文、损害可读性，不如改用 diff 等成熟工具。
问题是这会让文章读起来很难受。示例看着舒服，是因为文字少、又有颜色区分；一旦在普通文本编辑器里出现大量修改标记，版面会非常拥挤。为什么不用 diff 这类现成工具呢？
kghose查看英文原文
Unfortunately this will make it very annoying to read. The examples look pleasant because it is a small amount of text with color coding. When you have a lot of text with a lot of corrections displayed in a regular text editor this will get very very crowded. Why not use existing tools like diff?
存在更简明的括号记法，说明标记方案应当追求简洁易用。
这让我强烈想起一套我用了很久的更简单（在我看来也更优雅）的记法，链接见 azarask 的那篇博客。
robertskmiles查看英文原文
Reminds me very strongly of a simpler (and in my opinion more elegant) notation that I have been using for a long time: http://www.azarask.in/blog/post/collaboration_made_simple_with_bracket_notation/
同类还值得读
被低估的工程技能：把文章写好
Undervalued Engineering Skills: Writing Well
这篇文章讨论为什么“写得好”是被低估的工程能力，以及它如何在团队协作、系统设计和职业发展中持续带来回报。
写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选每行只写一句话：让写作和修改都更轻松的排版法
Writing one sentence per line
这是 Derek Sivers 的一篇短文，主张写作时每行只放一个句子，而不是按段落排版。
写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选书面沟通是远程工作的超级能力
Written communication is remote work super power
这篇文章讨论远程工作中书面沟通的价值，评论区则补充了异步与同步沟通的适用场景，并提醒读者：备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。
写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选如何写出有用的文字
How to Write Usefully
保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式：有用≈重要×新颖×正确×清楚，任一项为零，整篇文章就等于零；他还主张敢下确定判断、删掉让自己心虚的句子。
写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选如何写得更清楚、想得更清楚，并学会复杂材料（PDF）
How to write more clearly, think more clearly, and learn complex material [pdf]
这份 PDF 讨论如何把文章写清楚、把思路理清楚，并用写作来学习复杂材料。
写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选