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

    技术写作与文档2024stempad.io

    Stempad:快捷的在线科学写作工具

    Show HN: Stempad – Fast Online Scientific Writing

    阅读原文 HN 讨论
    144HN 得分
    45条评论
    5条写作要点

    导读

    这是一个面向理工科学生与研究者的在线科学写作编辑器:作者不满于「快速写公式和笔记只能靠手写」的现状,做了 Stempad,让键盘输入也能快速产出科学文档,并支持导出 LaTeX。对写作者来说,它提醒我们:写作工具的摩擦会直接决定你动笔的频率,选对工具、减少格式与排版上的阻力,是持续写作的前提。

    关键词 科学写作写作工具LaTeX降低摩擦

    可以直接用的写作要点

    1. 01

      把「能不能马上开始写」当作选工具的第一标准:作者的核心痛点不是功能不够,而是手写之外没有低摩擦的快速输入方式。

    2. 02

      尽量用专为你的文体设计的工具,别硬把科学内容塞进通用笔记软件或 Word,格式转换和公式排版会吃掉大量精力。

    3. 03

      让输出格式与最终用途对齐(例如直接导出 LaTeX),避免写完后再手工搬运,写作流程越短越容易坚持。

    4. 04

      用真实材料自测:作者拿已发表论文的一段重写并导出,验证工具能否支撑真实写作,而不是只看演示。

    5. 05

      观察身边人的写作痛点(课堂笔记潦草、拍照上传讲义),这些具体场景往往就是写作产品与写作方法的机会。

    同类还值得读

    1. 编写更好文档的框架

      A Framework for Writing Better Documentation

      这是 Divio 的文档写作框架,把技术文档按「读者的目标」分成四类:教程(学习导向)、操作指南(问题导向)、参考(信息导向)、解释(理解导向)。

      技术写作与文档2021 · 637 分 · 76 评4 条写作要点编辑精选
    2. 写好一份设计文档

      Writing a good design document

      这篇 HN 帖子标题为《Writing a good design document》,主题是如何写好一份设计文档;对写作者来说,它值得作为技术写作和结构化说明文的参照。

      技术写作与文档2025 · 581 分 · 147 评3 条写作要点编辑精选
    3. 技术写作课程

      Technical Writing Courses

      这是 Google 官方免费技术写作课程(两门),讲受众定义、主动语态、短句、文档结构等基础方法。

      技术写作与文档2020 · 571 分 · 73 评4 条写作要点编辑精选
    4. 写出更好的错误信息

      Write better error messages

      这篇帖子讨论如何写出更好的错误信息,评论补充了开发者场景下的具体做法和真实反面案例。

      技术写作与文档2022 · 566 分 · 253 评4 条写作要点编辑精选
    5. 写一本技术书的经济账

      The Economics of Writing a Technical Book

      一位技术书作者拆解写书的真实经济账:版税收入往往远低于投入的时间成本。

      技术写作与文档2018 · 519 分 · 149 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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