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 生成,可能有误。

    写作方法2018math.utah.edu

    如何写数学(1970)

    How to write Mathematics (1970) [pdf]

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

    导读

    这是数学家 Paul Halmos 1970 年的经典小册子《How to write Mathematics》,讲如何把数学写得清楚、可读。它谈的不只是公式与符号,而是结构、修改节奏和表达态度,因此对任何写说明性文字的人都有借鉴价值——HN 评论里最实用的一条,是所谓“螺旋式”写作计划。

    关键词 数学写作结构化写作修改与重写说明文

    可以直接用的写作要点

    1. 01

      采用“螺旋式”写作:按 1、2、1、2、3、1、2、3、4 的顺序反复回写前面章节,因为写完第二章你才会知道第一章该怎么改。

    2. 02

      把“写完”当成“写对”的起点:初稿只是探路,真正的结构是在回头重写时才浮现出来的。

    3. 03

      先想清楚读者要读什么,再决定写什么——Halmos 式的说明文以清楚和可读为最高标准,而不是以显得高深为标准。

    4. 04

      读一份“如何把文章写坏”的反面清单(如 Serre 的演讲),往往比读正面规则更快地改掉自己的坏习惯。

    HN 评论精选

    螺旋式写作:边写边回头重写前面章节,让后文反过来修正前文。

    按照螺旋式计划,各章按 1、2、1、2、3、1、2、3、4 这样的顺序写和重写。你以为自己会写第一章,但写完它、进入第二章之后,你会发现:如果当初第一章写得不一样,第二章本可以写得更好。我认为就一般性的结构化写作而言,这是最好的建议之一。

    annnoo查看英文原文

    According to the spiral plan the chapters get written and re-written in the order 1, 2, 1, 2, 3, 1, 2, 3, 4, etc. You think you know how to write Chapter 1, but after you’ve done it and gone on to Chapter 2, you’ll realize that you could have done a better job on Chapter 2 if you had done Chapter 1 differently I guess this is one of the best tips in terms of general structured writing.

    Halmos 的价值在于“阐述”本身:好的讲解文字可以跨领域地教人写作。

    Paul Halmos 是二十世纪最伟大、也最令人享受的数学阐述者之一。我读他的东西,确实学到了很多一般意义上的写作(不只是数学写作);十年前我学线性代数时,他的《有限维向量空间》也帮了我不少。如果链接里的文章太长,可以读他那篇更短的《数学作为创造性艺术》。

    n4r9查看英文原文

    Paul Halmos is known as one of the greatest and most enjoyable expositers of mathematics of the twentieth century. I've certainly learnt a lot about writing in general (not just mathematical) from reading his stuff, and his book "Finite Dimensional Vector Spaces" was an aid to me when I was learning Linear Algebra ten years ago. If the linked text is too long, you might enjoy his shorter piece "Mathematics as Creative Art" [0]. [0] http://www-history.mcs.st-andrews.ac.uk/Extras/Creative_art.html

    反面教材同样有效:看别人怎样把文章写坏,比记正面规则更容易改掉毛病。

    想多读 Halmos 的人,可以看看他的《我想当数学家:一部自传式数学人生》。同样值得一看的是 Serre 的《如何把数学写得很糟》。

    ocfnash查看英文原文

    For anyone looking for more of Halmos, his book "I want to be a mathematician: an automathography" is worth a look. Also well worth a look is Serre's "How to write mathematics badly": https://www.youtube.com/watch?v=ECQyFzzBHlo

    可与 Knuth 的《Mathematical Writing》对照读,一个讲原则、一个讲操作。

    当然还有 Knuth 的《Mathematical Writing》版本,看起来更偏具体操作层面;这篇帖子正好与之互补。

    cschmidt查看英文原文

    Of, course there is Knuth's version of "Mathematical Writing" as well. http://jmlr.csail.mit.edu/reviewing-papers/knuth_mathematical_writing.pdf which seems a bit more nut-and-bolts. This post seems a good compliment.

    同类还值得读

    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

    关注向阳乔木

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

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

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