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

    写作方法2020writemd.xyz

    Show HN:Write.md——可分享的免打扰 Markdown 写作编辑器

    Show HN: Write.md – a shareable distraction-free Markdown editor

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

    导读

    这是一个极简 Markdown 编辑器的发布帖,评论区主要围绕“该用哪个在线 Markdown 工具”展开对比:自托管 HackMD、Dillinger、StackEdit 等。对写作者来说,这类讨论的价值在于帮你判断什么样的写作环境能真正减少打断——功能多不一定好,预览与滚动是否同步、能否协作与导出,才影响写作节奏。

    关键词 Markdown写作工具专注写作协作

    可以直接用的写作要点

    1. 01

      选写作工具的标准是“能不能让你一口气写完”,而不是功能清单有多长。

    2. 02

      Markdown 纯文本便于迁移与长期保存,避免被某个平台锁定,写完的稿子随时能带走。

    3. 03

      支持实时协作与多形态导出的工具(如把要点直接转成演示稿)能让同一份素材一稿多用。

    4. 04

      编辑器与预览窗口不同步会不断把注意力拉回界面上,正式写作前先试用滚动和预览体验。

    HN 评论精选

    自托管 Markdown 工具兼顾协作与插件扩展,还能把笔记直接变成演示稿。

    我用的是自托管的 HackMD(现在叫 CodiMD)。托管版越来越推着你注册账号,但直接访问新建页面就能不注册开始写。它支持实时协作,还有一长串插件,能覆盖各种协作场景,比如几乎不费力气就把几个要点条目转成一份演示稿。相比 HackMD,Write.md 提供了什么?我和 HackMD 没有利益关系,只是个满意的用户,也一直好奇有没有替代品。

    eipi-1查看英文原文

    I use a self-hosted HackMD (now CodiMD) [1] instance for this. The hosted version pushes more and more towards account creation but you can start without account by visiting [2] directly. They have real time collaboration and a long list of additional plugins [3] that allow all kinds of nice collaboration use cases. For example it is possible to convert some bullet points into a presentation with minimal effort. What does Write.md provide compared to HackMD? Not affiliated with HackMD, just a happy user and always curious about alternatives. [1] https://github.com/hackmdio/codimd [2] https://hackmd.io/new [3] https://hackmd.io/features

    同类工具有功能更完整的成熟选择,值得先做横向对比。

    Dillinger 是我首选的在线 Markdown 编辑器。把两者放在一起看,它在功能上远超这个方案。

    gravitas查看英文原文

    Dillinger is my online Markdown editor of choice, having a look between the two it's far beyond this solution in features. https://dillinger.io/ https://github.com/joemccann/dillinger

    同类产品同质化明显,切换工具的成本往往大于收益。

    我一直在用 StackEdit,看起来和这个很像。

    ollo查看英文原文

    I've been using https://stackedit.io/. They look very similar.

    编辑与预览不同步会打断写作节奏,是选择编辑器时要实测的细节。

    滚动有点问题。我滚动编辑区时,预览区看似在跟着走,其实并不同步。比如我能看到编辑区底部的两节(“What is markdown”等),但预览区里还没出现;等我滚到编辑区最底部,预览区才突然跳到底。

    laurent123456查看英文原文

    Something's off with scrolling. If I scroll the editor, the viewer seems to follow but actually it's not in sync. For example, I can see the two bottom sections in the editor ("What is markdown", etc.), but they aren't yet visible in the viewer. Once I reach the bottom of the editor, the viewer suddenly jumps to the bottom.

    同类还值得读

    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

    关注向阳乔木

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

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

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