HN 写作课

工程师们二十年里聊过的写作。

工程师、作家、编辑和创业者在 Hacker News 上聊了二十年“怎么写”:怎么写得清楚、怎么讲好一个故事、技术文档怎么写、小说和出版是怎么回事。这里把其中关于写作与讲故事的帖子挑出来,配上中文导读、可以直接用的写作要点和评论翻译。

从必读开始
  • 2,600+篇关于写作的 HN 讨论

Writing tips

写作锦囊

正在抽一条写作要点…

Essential

必读 30 篇

在讨论库里看全部精选

编辑精选里 HN 讨论最热的 30 篇,每篇都有中文导读和写作要点。

  1. 正在载入…

Archive

讨论库

按发帖年份分布,点柱子筛选。

排序

    About

    这些讨论是怎么挑出来的

    1. 01

      从全量里捞

      读取 Hacker News 自 2006 年以来的全部帖子,用关键词先捞出 40 分以上、可能和写作有关的约 1.1 万篇。

    2. 02

      只留真正讲写作的

      由 AI 逐条判断是否和写作、讲故事、文风、出版有实质关系,剔除“写代码”“编辑器”这类字面撞车,并分进十个类别。

    3. 03

      提炼可用的要点

      为值得读的帖子写中文导读,提炼 2-4 条可以直接用到自己写作里的要点,并精选翻译 HN 高赞评论。内容由 AI 生成,可能有误。

    写作方法2022dynomight.net编辑精选

    我如何不再焦虑,并把所有写作都组织成清单

    How I learned to stop worrying and structure all writing as a list

    阅读原文 HN 讨论
    479HN 得分
    131条评论
    4条写作要点

    导读

    这篇文章讲作者如何放弃对文章结构的焦虑,把几乎所有写作都组织成“列表”:把内容拆成若干互相独立、可单独阅读的小节。对写作者来说,它提供了一种降低结构负担、又能保证信息密度的实用写法;文末也讨论了这种结构在衔接上的短板,以及如何在开头弥补。

    关键词 文章结构列表写作提纲衔接

    可以直接用的写作要点

    1. 01

      把文章拆成互不依赖的小节,每节只讲一件事,读者可以按任意顺序跳读。

    2. 02

      小节之间缺少的“连接组织”必须由作者补上,否则读者会自行脑补逻辑,往往补错。

    3. 03

      先列提纲再写,再把提纲显性化成可见的小标题或列表,比藏起来的提纲更容易变成清晰的开头。

    4. 04

      若采用列表结构,就在开头用一段正常行文交代整体脉络和内在联系,弥补列表带来的碎片感。

    HN 评论精选

    连接组织不能省,否则读者会错误地自行补全逻辑。

    如果你倾向于把一切写作都削成列表,建议读读塔夫特关于 PowerPoint(即把一切都写成项目符号列表)在挑战者号航天飞机事故中扮演何种角色的分析。我曾只写项目符号和提纲式文章,读了塔夫特的分析后改了:文档的“连接组织”对读者至关重要,即使对作者不重要。你不写连接组织,读者就得替你去写,而且很可能写错——比如没能阻止挑战者号事故那样的后果。

    yodon查看英文原文

    If you're leaning towards stripping all your writing down to list form, you may want to read Tufte's analysis on the role PowerPoint (aka writing everything in the form of bulleted lists) played in the Space Shuttle Challenger disaster [0]. I used to write exclusively in bulleted list/outline format until spending time with Tufte's analysis. Now I get that the connective tissue of the document is vitally important to the reader even if it's not important to the writer. If you don't put in the connective tissue, your reader has to do it for you and they'll probably do it incorrectly (leading to, for example, the failure to prevent the Challenger disaster). [0]https://www.inf.ed.ac.uk/teaching/courses/pi/2016_2017/phil/tufte-powerpoint.pdf

    列表文章其实就是把提纲显性化,提纲还能顺手变成开头的导语。

    也许是暴露年龄了,但我受的写作训练是先列提纲,把想法组织成连贯的顺序。列表式文章基本上就是把提纲直接摆到台面上;而提纲也很容易改写成开头段落,正好解决文章结尾提到的那种结构被当成大纲的问题。

    wrs查看英文原文

    Maybe I’m dating myself, but I was taught to start writing by coming up with an outline, which helps you organize your ideas into a coherent sequence. A list article basically makes its outline visible. The outline is also easily turned into an introduction that can address the non-list structure problem at the end of this article.

    核心其实是分节标题,列表只是形式。

    这听起来更像是在主张用小标题,跟“列表”那部分关系不大。

    verve_rat查看英文原文

    This seems like an argument for using headings. The "list" part seems irrelevant.

    文章的重点是“无依赖的小节”这一题材特性,不是项目符号。

    高赞评论没有公正对待这篇文章。它真正讲的是:哪些题材可以被拆成互不依赖的小节来深入展开。文章先说明这类题材为何有价值,再说明这类文章需要自我声明为“列表”来公开这一事实。论证非常扎实,建议读全文。注意:文章讲的不是层级式项目符号列表。

    rahimiali查看英文原文

    The top comments aren’t doing the article justice. The article is really about the kinds of subjects that can be covered in depth as small sections that do not have dependencies between them. It explains the value of topics that can be presented this way, then explains these articles need to publicize this fact by claiming to be lists. Seriously well argued position and I recommend reading the whole thing. Notability the article is not about hierarchical bulleted lists.

    同类还值得读

    1. 被低估的工程技能:把文章写好

      Undervalued Engineering Skills: Writing Well

      这篇文章讨论为什么“写得好”是被低估的工程能力,以及它如何在团队协作、系统设计和职业发展中持续带来回报。

      写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选
    2. 每行只写一句话:让写作和修改都更轻松的排版法

      Writing one sentence per line

      这是 Derek Sivers 的一篇短文,主张写作时每行只放一个句子,而不是按段落排版。

      写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选
    3. 书面沟通是远程工作的超级能力

      Written communication is remote work super power

      这篇文章讨论远程工作中书面沟通的价值,评论区则补充了异步与同步沟通的适用场景,并提醒读者:备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。

      写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选
    4. 如何写出有用的文字

      How to Write Usefully

      保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式:有用≈重要×新颖×正确×清楚,任一项为零,整篇文章就等于零;他还主张敢下确定判断、删掉让自己心虚的句子。

      写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选
    5. 如何写得更清楚、想得更清楚,并学会复杂材料(PDF)

      How to write more clearly, think more clearly, and learn complex material [pdf]

      这份 PDF 讨论如何把文章写清楚、把思路理清楚,并用写作来学习复杂材料。

      写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

    觉得有用,请作者喝杯咖啡。

    WeChat

    关注向阳乔木

    微信公众号「向阳乔木推荐看」

    微信公众号「向阳乔木推荐看」二维码

    微信扫一扫;在微信里打开本页时,长按二维码识别。