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

    文案与商业写作2020quixoticnomad.blog编辑精选

    技术文案写作:工程师能从苹果 M1 MacBook 营销中学到什么

    Technical Copywriting:What Engineers Can Learn from Apple’s M1 MacBook Marketing

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

    导读

    这是一篇分析苹果 M1 MacBook 营销文案的博客,作者试图总结工程师写技术文案可以借鉴的手法,比如少堆数字、多讲实际好处、语气像聊天。评论区的反驳比原文更有价值:有人指出它把广告文案当成技术写作来推崇,还忽略了受众和品牌前提;也有人现身说法,说无标注的对比图反而让人不信。适合写作者读,是因为它示范了「好文案」和「可信表达」并不是一回事。

    关键词 文案写作技术写作营销受众意识

    可以直接用的写作要点

    1. 01

      把「无风扇」这类特性翻译成读者能感知的场景(工作时听不到风扇狂转),而不是只罗列参数。

    2. 02

      图表和对比必须交代清楚对象与刻度,含糊的「对比顶级 PC 笔记本」会削弱可信度,甚至适得其反。

    3. 03

      借鉴大品牌的文案前先确认前提:你的受众是谁、你的品牌能否支撑这种口气,否则同样的写法会失效。

    4. 04

      先分清你写的是说服性广告还是精确传达的技术文档,两种文体的规则不同,不要混为一谈。

    HN 评论精选

    别把营销话术当成产品事实,也别脱离受众和品牌条件照搬大厂写法。

    作者把广告词读得太深、太当回事了。「免费」那句我原以为是暗讽不送充电器;「无风扇也没有性能妥协」其实并不成立,MacBook Air 长时间高负载约十分钟就会降频,苹果自己也只说了轻薄和无风扇。所谓「人们讨厌风扇噪音」更像是先想出一个差异化卖点再倒推理由。文章通篇没提受众,也没说什么情况下这些手法会失灵,只是把苹果的说法照单全收。

    BossingAround查看英文原文

    > Finally, ending with “free of charge” lets us know that we aren’t going to paying more for this increased efficiency. Hmm, I thought this was a cleverly veiled joke. Free of charge no charger, wink wink chuckle. > However, even without a fan, there is no tradeoff with performance. There most certainly is a trade off with performance. The Macbook Air throttles after around 10m of extensive work as far as I know. The marketing claims no such thing, either. It just claims that the Macbook Air is thin and fan-less. > real problem is that most people hate the sound of their laptop’s fan cranking away while they are trying to get work done This is a bit of a generous interpretation. Instead, I'd argue that Apple thought how they can differentiate, and came up with the idea of reducing fan noise, which can be considered a "cool feature". The fact that their faulty keyboards on the previous 3 (?) generations of Macbooks were insanely loud and obnoxious somehow didn't matter in their quest for silence. The article strikes me as looking too deep into something it idolizes. Yes, Apple is great at marketing. Can you get away with the same writing if you're a small or a medium-sized company? Depends on who's your target audience (and I'm sure it also depends on your brand). Funnily enough, the article doesn't mention target audience. It doesn't mention why certain tactics work (or when would they not work). It takes Apple's claims at face value, without deeper thought. I think a fellow commenter summary of "sell benefits, not features" is fair to the article, as the article doesn't offer that much more.

    含糊的对比会适得其反,具体、可核实的参照物才建立信任。

    苹果那些没有标注的图表,以及只写「顶级 PC 笔记本」却不点名对比对象,反而让我以为 M1 会翻车,实际还不如当时的高端戴尔。现在看 M1 确实很强,但这绝不是我从那套广告里得到的印象。

    CJefferson查看英文原文

    Apple's graphs without labels, and comparing to "top PC laptops" without naming them actually made me assume the M1 was going to be a flop, and in practice worse than a current high-end Dell laptop. It now looks like that isn't true, and the M1 really is revolutionary, but that certainly isn't what I took away from Apple's advertising.

    说服性文案与精确传达是两种文体,先认清自己在写哪一种。

    别把技术写作和科技产品广告混为一谈。广告和推销话术不是技术写作;技术写作是把复杂、细节化的东西讲得清晰准确,广告则相反,目的是说服。想学广告就去正经学广告,别换个名字装成别的东西。技术写作可以是广告文案的输入,但广告里放张图表并不等于技术写作。

    finnthehuman查看英文原文

    > Technical Copywriting: What Engineers Can Learn from Apple’s M1 MacBook Marketing Let's not play too fast and loose with the distinction between technical writing and ad copy for a technology. This article wastes times talking around the point: advertisements and sales pitches are not technical writing. Technical writing is about clear and precise communication of complicated and/or detailed ideas. Ads are the opposite, ads are about persuasion. Full stop. End of. If you want to learn ads, learn ads. Do it properly and don't pretend it's something else. Technical writing can be an input to ad copywriting, but the presence of a graph or chart in an ad does not make it technical writing.

    三条可操作的文案原则:说人话、讲好处、别端着。

    总结一下:一、用受众能听懂的清楚简洁的语言;二、讲具体可感的好处,而不是只甩数字;三、保持口语化、像对话的语气。

    jdhn查看英文原文

    To sum it up: 1) Use clear, concise language that your audience will understand. 2) Focus on tangible benefits, not just pure numbers. 3) Have a conversational tone.

    同类还值得读

    1. 好文笔是一种商业优势

      Good writing is a business advantage

      这是广告人 George Tannenbaum 的一篇博客短文,主张清晰的写作在商业中是实打实的竞争优势——能把事情说明白的人,在会议、邮件、提案里就已经赢了一半。

      文案与商业写作2020 · 449 分 · 198 评4 条写作要点编辑精选
    2. 如何为落地页撰写文案

      Writing copy for landing pages

      这是 Stripe Atlas 关于落地页文案的写作指南,核心是把文案当成回答读者疑问的工具,而不是自我表达。

      文案与商业写作2018 · 416 分 · 84 评4 条写作要点编辑精选
    3. 我曾是扎克伯格的演讲稿撰写人

      I was Zuckerberg’s speechwriter

      这篇是第一人称回忆:作者曾为扎克伯格写演讲稿,借此复盘在剑桥分析丑闻前后,科技巨头的公开表达如何被构思、修饰和交付。

      文案与商业写作2018 · 347 分 · 254 评4 条写作要点编辑精选
    4. 一句话产品描述写作的艺术

      The Art of Writing One-Sentence Product Descriptions

      这篇文章讨论如何为产品写一句话描述,核心是把复杂产品压缩成一个能打动人的句子。

      文案与商业写作2017 · 335 分 · 57 评4 条写作要点编辑精选
    5. Ask HN:为技术岗位写求职信

      Ask HN: Writing cover letters for tech jobs

      这篇 HN 讨论科技岗位是否需要写求职信、写给谁看、用什么语气和格式。

      文案与商业写作2017 · 265 分 · 123 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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