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

    写作方法2017golem.ph.utexas.edu编辑精选

    论写短论文

    On Writing Short Papers

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

    导读

    这是一篇讨论如何把学术论文写短、压短的文章,核心是篇幅有限时该删什么、留什么。对写作者的价值在于:它把“简洁”拆成了可操作的取舍清单,也提醒你删减总是有代价的——省下的篇幅往往要用可读性来换。

    关键词 学术写作简洁篇幅压缩可读性

    可以直接用的写作要点

    1. 01

      压缩篇幅优先动“形式”:缩小图表、把多张图合并成一张、删掉插入语、把冗长的引用列表缩写。

    2. 02

      删过渡句和例子能快速省字,但这是拿可读性换篇幅,要清楚自己付了什么代价。

    3. 03

      把完整证明、推导等长内容放进补充材料,正文只留主线,既短又不丢信息。

    4. 04

      学 Axios 的写法:先给结论、要点分块、视觉上可扫读,让读者几秒钟抓到重点。

    HN 评论精选

    区分“压缩长文”和“写短论文”,并给出具体压缩手段及其可读性代价。

    这篇讲的是如何“缩短”论文(把篇幅压进页数上限,很有用),而不是如何写“短论文”——后者通常指篇幅更短、分量较轻的一类论文,与“全文/长文”相对。若想压缩论文:缩小图表、把多个图合成一张、压缩图注与图之间的间距、删去插入语、缩短参考文献列表(如 [3, 4, 7, 11, 15])。代价是可读性下降,还可以开始删过渡句和例子。

    azhenley查看英文原文

    This describes how to _shorten_ your paper (which is useful to get it within page budgets). This is not how to write "short papers", which is a term generally used for lesser papers with a shorter page budget, as opposed to a "full" or "long" paper. If you want tips on how to condense a paper: shrink figures and tables, put multiple charts into a single figure, reduce the space between captions and figures, omit parentheticals, and shorten lists of references (e.g., [3, 4, 7, 11, 15]). At the cost of readability, you can also begin removing transitional phrases and examples.

    正文删掉的内容应放进补充材料,而不是直接消失。

    “省略或缩短证明”这类建议说明,也许更多论文该配补充材料。证明完整写出来放在某处绝对有价值,尤其对没有博士学位的读者来说,他们也想从你的研究里获益。如果期刊开始鼓励(甚至托管、镜像)补充材料,会很有意思。

    nerdponx查看英文原文

    A lot of these points, like "Omit or shorten proofs", suggest that maybe more papers should have companion materials. Having the proof written out somewhere is definitely valuable (especially for us non-doctorate-holders who still would like to benefit from your research). Would be especially interesting if journals started encouraging (and perhaps hosting/mirroring) supplemental materials.

    要点化、可扫读的排版本身就是一种简洁写法,值得借鉴。

    Axios 是个有意思的例子:它改变了新闻报道的写法,让内容既更简洁又更适合视觉扫读,读者更容易抓到重要信息。可以对比一篇传统写法的文章。我确实认为,我们在网上用文字沟通的方式需要继续演化,因为我们阅读和学习的方式已经大不相同。

    chasing查看英文原文

    (This is not a statement about their journalistic quality. But:) Axios is an interesting example of changing the format of news story writing to be both more concise and more visually scannable. And, thus, easier to glean important info from. See, for example: https://www.axios.com/wearables-still-slow-to-catch-on-in-the-u-s-2518970213.html?utm_source=sidebar Compare to a more traditionally written article: https://www.nytimes.com/2017/12/21/us/politics/facial-scans-airports-security-privacy.html I do think the way we communicate with the written word online needs to continue to evolve. The way we read and learn is certainly very different. Anyway. That's what this article makes me think of.

    半开玩笑的批评:谈简洁的文章自己也要简洁,别双重标准。

    我的红笔呢?一篇讲简洁的文章,本身废话不少。 ;-)

    chasing查看英文原文

    Where's my red pen? For an essay about brevity, this has a lot of fluff. ;-)

    同类还值得读

    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

    关注向阳乔木

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

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

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