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

    语言与文风2014hemingwayapp.com

    海明威写作应用现已上线

    Hemingway App now available

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

    导读

    Hemingway App 桌面版发布,评论既反馈功能与文案问题,也用实际文本展示它的可读性检测结果。对写作者来说,它提醒我们关注句子难度、副词、复杂词和被动语态,也提醒文案要面向不熟悉产品的读者。

    关键词 写作工具可读性文案写作编辑修改

    可以直接用的写作要点

    1. 01

      用可读性工具检查长难句比例,把“难读/非常难读”的句子改短或拆分。

    2. 02

      控制副词和复杂词:能删的副词删掉,能用简单词替换的就替换。

    3. 03

      多用主动语态,少用被动语态,让动作和执行者更清楚。

    4. 04

      写产品/项目文案时,先交代背景,再讲差异化价值;不要把基础功能当卖点。

    HN 评论精选

    文案应突出差异化价值,而非把基础能力当卖点。

    营销文案让我困惑。它强调的两点——离线工作、保存和编辑文本文件——在我看来是任何文本编辑器标准且必需的功能。如果你的文本编辑器不能保存和编辑文本文件(?!)且只能在线使用,那几乎不配叫文本编辑器。Hemingway 能做到这些是必要的,但为什么要强调这些,而不是真正的功能?补充:看回复我明白这些功能是相对于 Hemingway 网页版而言;但如果这页也面向不熟悉网页版的人,我仍坚持我的观点。

    patmcc查看英文原文

    The marketing copy is puzzling to me. Two things it highlights are what I would consider standard and required features for any text editor; the ability to work offline and the ability to save and edit text files. If your text editor can't save and edit text files (!?!) and can only be used online, it's hardly even worth calling a text editor. That Hemingway can do what's required is necessary, but why draw attention to those things instead of actual, you know, features? Edit: by the replies, I see these features make sense in comparison to Hemingway the web app. However, if this page is also intended for people not familiar with the web app, I stand by my points.

    即使高管公开信也常有大量难读句、副词和可简化表达,说明可读性检查有参考价值。

    只是好玩,我把 Satya Nadella 的公开信跑了一遍,得到:186 句中有 39 句难读,35 句非常难读;35 个副词(目标 17 个或更少);26 个词或短语可以更简单;15 处被动语态(目标 37 处或更少)。

    o0-0o查看英文原文

    Just for giggles, I ran the Satya Nadella letter[1] through here, and this is what I got: 39 of 186 sentences are hard to read. 35 of 186 sentences are very hard to read. 35 adverbs. Aim for 17 or fewer. 26 words or phrases can be simpler. 15 uses of passive voice. Aim for 37 or fewer. [1] http://www.microsoft.com/en-us/news/ceo/index.html

    面向新读者的文案需要交代产品背景,命名和定位也应一致。

    读完评论,我现在理解为什么营销文案把保存和打开文本文件当作卖点。这个页面没提网页版(据我所知),而我从没听说过 Hemingway App,所以我一开始很困惑:对一个文本编辑器来说,保存/打开文件和离线编辑为什么值得提。我不是说文案写得差(其实写得很好),只是觉得没有足够内容面向像我这样的读者。也许简单链接回网页版并加些说明就够了。小挑剔:“Hemingway App”和“Hemingway Editor”的用法有点混乱。我理解网页版是 Hemingway App,桌面客户端是 Hemingway Editor?那为什么页面标题是“Hemingway App for Mac OSX”?(顺便,标题里没有 Windows?)

    mztan查看英文原文

    After reading the comments, I now understand why the marketing copy touts saving and open text files as a feature. Given that there is no mention of the web app (AFAICT) on this page and that I had never heard of Hemingway App before, I initially was very confused as to why, for a text editor, saving/opening files and editing text offline would even be worth mentioning. I'm not saying the copy is poorly written (in fact I think it's written quite well), I just think that perhaps not enough of it is directed at people like me. Maybe a simple link back to the web app and some text explaining it would suffice. Also, a minor nitpick: I think the usage of "Hemingway App" and "Hemingway Editor" is a bit confusing. I take it the web app is Hemingway App, and the desktop client is Hemingway Editor? Why, then, is the page title "Hemingway App for Mac OSX"? (side note, no love for Windows in the title?) Not sure why I chose this comment to be my very first comment on HN.

    同类还值得读

    1. 像说话一样写作

      Write like you talk

      这篇短文主张写作应像说话一样自然、清晰,避免装腔作势的书面腔。

      语言与文风2015 · 647 分 · 272 评4 条写作要点编辑精选
    2. 法律语言难懂源于写作不佳,而非专业概念

      Poor writing, not specialized concepts, drives difficulty with legal language

      这是一项认知科学研究:法律文本难懂,主要不是因为充斥专业术语,而是因为写作者把句子写得又长又绕、修饰语层层嵌套、回指距离过远。

      语言与文风2022 · 559 分 · 322 评5 条写作要点编辑精选
    3. 写得简单

      Write Simply

      保罗·格拉汉姆在这篇短文里主张:好文章应该写得简单——用日常词汇、短句、直白的结构,不为显得聪明而堆砌复杂表达。

      语言与文风2021 · 484 分 · 330 评4 条写作要点编辑精选
    4. Tortured phrases:科学写作中出现的一种可疑文风

      Tortured phrases: A dubious writing style emerging in science

      《自然》新闻报道了一种在科学论文中蔓延的怪现象:原本标准的术语被同义替换软件改写成了古怪说法,比如把 "cloud computing" 写成 "haze figuring"。

      语言与文风2021 · 329 分 · 256 评4 条写作要点编辑精选
    5. 乔治·奥威尔 1940 年对《我的奋斗》的书评

      George Orwell's review of Mein Kampf (1940)

      这是奥威尔1940年对《我的奋斗》的书评。

      语言与文风2014 · 305 分 · 240 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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