写作方法2014github.com
渲染式散文差异对比
Rendered Prose Diffs
导读
GitHub 推出了“渲染后的散文差异”（Rendered Prose Diffs）功能，把 Markdown 文本的改动按词、句渲染出来，让作者能一眼看清自己改了什么。对写作者来说，这篇值得一读，因为它说明版本控制不只是程序员的工具，也是写作和协作修改时看清修订、回看历史的好帮手。
可以直接用的写作要点
- 01
逐行对比（line diff）对散文几乎没用，按词对比（word diff）才能看清一句话到底改了哪几个字。
- 02
把稿子用 Markdown 等纯文本格式存进 Git，就能拥有完整的修改历史，随时回看每一版怎么演变。
- 03
想让对比更清楚，可以用 `diff --color-words` 或 `wdiff` 这类按词对比的工具。
- 04
多人协作改稿时，版本控制能让每个人的修改都有记录、可追溯，避免改乱了找不回原句。
HN 评论精选
用 Markdown 在 GitHub 上写书，能直接享受清晰的散文对比。
这个功能太棒了。我正在写一本书，用 Markdown 写在 GitHub 上，它的差异对比效果非常好（附了具体 commit 链接）。
munificent查看英文原文
This is wonderful. I'm writing a book[1] and it's in markdown and on github. The diffs look great for it: https://github.com/munificent/game-programming-patterns/commit/2a02d1f8c5093a73e5258c55aac3b0f531d01435#rdiff-5e512bb6ba6e40cffa2a6bdab2cfb5a0 [1]: http://gameprogrammingpatterns.com/
逐行对比对散文不透明，应按词对比才能看清编辑内容。
按词对比对散文非常有用；逐行对比在编辑文本时完全看不懂。如果你看过大量逐行对比的校对稿，根本不知道到底改了什么。看维基百科的编辑记录，想象用默认的 git log 查看会是什么样……好在可以用 `diff --color-words` 或 `wdiff` 得到更好的对比。
gwern查看英文原文
Word-diffs are great for prose; line-based diffs are completely opaque for editing. If you've ever looked at a lot of copyediting in a line-based diff, you have no idea what actually happened. Look at some edits on Wikipedia and imagine trying to view them in a default git log... Fortunately, you can use `diff --color-words` or a tool like `wdiff` to get better diffs. (An example: http://www.gwern.net/docs/2002-radiance#diff )
文本存成文件、用 Git 管理，与内容管理系统天然契合。
这和 Git + 基于文件的 CMS 做法完美契合，比如 Asana 就是这么用的（附链接）。功能很酷！
bri3d查看英文原文
Ties in perfectly with the Git + file-based CMS approach as used by (one of many examples) Asana: http://eng.asana.com/2014/02/scaling-asana-com/ . Cool feature!
版本控制是写作者（尤其协作时）的杀手级功能。
太棒了！版本控制对写作者来说是杀手级功能，尤其是多人协作时。其实已经有一些为写作者提供版本控制的项目，比如 Draft 和 Penflip。
edj查看英文原文
This is fantastic! Version control is a killer feature for writers, particularly those working collaboratively. There are actually already a few projects out there that offer version control for writers. Draft and Penflip come to mind. Draft: https://draftin.com/ Penflip: https://www.penflip.com/
同类还值得读
被低估的工程技能：把文章写好
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 条写作要点编辑精选