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

    写作方法2021zeminary.com

    Show HN:面向写作者的电子表格

    Show HN: A spreadsheet for writers

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

    导读

    这是一个面向写作者的"电子表格式"写作工具(每个格子当一段/一块内容,可自由增删行列)。评论区几乎没有讨论写作本身,而是集中吐槽一件事:页面没有说清它是什么、怎么用。对写作者来说,这是一堂现成的"如何向陌生读者解释你的东西"的示范课。

    关键词 写作工具产品说明用户体验演示与举例

    可以直接用的写作要点

    1. 01

      你对自己作品的背景知识是最大的盲区:写完任何说明文字,都要假设读者只看了这一屏、且不认识你,仍能看懂"这是什么、解决什么问题"。

    2. 02

      能用一段 15 秒的演示(动图、录屏、截图)说明的,不要用文字硬讲;写作者也一样,举例和片段比抽象描述有效得多。

    3. 03

      借用读者已有的心智模型("像 Excel 一样的格子""像 Trello 看板")能大幅降低理解成本,但前提是把相似和不同说清楚。

    4. 04

      别让关键操作只藏在无标签的小图标里;标题、提示、旁注这些"可见的路标",是读者/用户能否留下来的关键。

    HN 评论精选

    默认读者一无所知:缺一句"这是什么",绝大多数人就会离开。

    你的帖子和网站如果能说清楚"这是什么、怎么运作",效果会好得多。你可能花了几个月甚至几年做它,所以对你显而易见,但对我们不显然;你引流来的访客里 99.99% 会因为没有解释而直接走掉。

    yodon查看英文原文

    Your post and site would be far more effective with an explanation of what it is and how it works. You probably spent months or years crafting this so it's obvious to you but to the rest of us it's not and 99.99% of visitors you drive to your site are just going to move on without an explanation.

    交互要贴合读者已经养成的习惯(拖拽、右键菜单、加号),而不是让人去猜图标。

    移动、调整大小、新增都太难了:要先点工具栏里一个没有提示的晦涩图标,再点好几下才能到想要的操作。拖动本该是自然的,可以设计成按住某键才触发以免误触,或在角上放一个明确的拖拽点;缩放这事操作系统里大家已经用了十几年;新增的话,也许可以在相邻行列放个"+"号直接生成;把其他命令放进右键菜单也会更好用——那正是我们用 Word/Excel 的习惯。

    jve查看英文原文

    Moving, resizing, adding is so hard. Clicking on some obscure icon within toolbar, that doesn't even feature tooltip for more explanation and then multiple clicks to get down to the operation I want... It is natural to be able to drag. Maybe pressing some key so that doesn't happen accidentally, or have some snap in corner that must be dragged. Resizing... we do intuitively within OS for decades... Adding. Perhaps + sign can be added in the adjacent column/row, that spawns new one. Having other commands within right click would also be helpful. Well, that's at least how we are used to use word/excel.

    用短演示和截图展示成品效果,并给每个按钮加可见的说明文字或提示。

    如果你觉得快捷键很重要,就需要一段 15 秒的高速 GIF/录屏,最好把按键显示出来;至少放一两张"文档进行中"的截图(推特里好像有截图,但能展示一个复杂文档就更好了)。另外给导航栏和编辑器工具栏按钮加上 title 属性,否则完全看不出各自干什么。点"?"看帮助是有用的,但我看完部分函数名的源码后仍不知道那些菜单图标是什么意思;文件图标和编辑器图标干脆显示成缺字的方框(U+25A1)。我怀疑很多首次访客根本不会去点开那个编辑器——它看起来其实很不错。我大致理解了:每个方块是一个格子,不像 Excel 那样把空白页的空格都画出来,你往格子里填内容,再按需增删行列,愿意的话最终可以做得像一块 Trello 看板。

    password4321查看英文原文

    You need a high-speed 15 second GIF/mp4 screencast with keypresses visible (maybe use a trial of Camtasia) if you think all the hotkeys should be used a lot. At least a screenshot or two of a "document" in progress! (Screenshots here apparently: https://twitter.com/Zeminary/status/1432195697449766921, though it would be cool to show a complex document.) Also, set the title attribute on your navbar item divs and modal editor toolbar buttons, otherwise there is no idea what each does. Clicking the '?' for help is useful, but I still don't have any idea what menu icons do even after looking at the source for some of the function names. I don't even see the Unicode characters for the file & modal editor, they are just the U+25A1, white square (representing a missing ideograph). I doubt many first-time visitors / potential users will even click to view the modal editor, it seems great. I think I get the idea of each square being a cell, not showing empty cells like Excel does for a blank page. Then you fill in each cell in the grid and add/remove rows/columns as desired. So it could wind up looking like a Trello board if you wanted to use it that way.

    作者会为了写作把任何工具用成自己的样子,形式并不是门槛。

    八十年代末我在一个学术机构工作,那时个人电脑还是极客的领域。我记得有个人除了 Lotus 1-2-3 之外不会用任何软件,但她把整封信和整份文档都写成电子表格,所有文字塞在一个巨大的单元格里。我唯一佩服的是,单元格里塞到 65535 个字符时程序居然没崩。

    cratermoon查看英文原文

    In the late 80s I was working at an academic institution, and personal computers were still mostly the domain of nerds. One person I remember didn't know any other program except Lotus 1-2-3. But she used to write entire letters and documents as spreadsheets, with all the text in one gigantic cell. The only thing I found impressive about that was that the program didn't crash when it hit 65,535 letters in a cell.

    同类还值得读

    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

    关注向阳乔木

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

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

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