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

    博客与个人写作2018writefreely.org

    WriteFreely:极简的联邦化博客平台

    Show HN: WriteFreely – minimalist, federated blogging platform

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

    导读

    这是极简、联邦式博客平台 WriteFreely 的发布贴,作者讲述它如何从注重隐私的 Write.as 演化而来,并加入 ActivityPub 支持、开放源码。对写作者而言,它既是可选的写作工具,也提醒我们:产品介绍里的行话会直接影响读者是否愿意读下去。

    关键词 写作工具极简主义去中心化读者意识

    可以直接用的写作要点

    1. 01

      标题和产品描述里出现读者不熟悉的术语(如“federated”),会让人还没读就失去兴趣,写任何介绍文字都要先确认用词在读者那里是通的。

    2. 02

      界面和功能做减法本身就是一种写作主张:工具越安静,注意力越容易留在文字上;自己的文章也可以按这个标准删装饰、删枝节。

    3. 03

      稳定来自长期积累——Write.as 跑了四年代码才谈得上稳,写作同理,持续写比追求一次爆发更可靠。

    4. 04

      先想清楚“写给谁看”,再决定用什么词、讲多少背景;受众不清,措辞就会在两拨人之间摇摆。

    HN 评论精选

    项目由四年稳定运行的 Write.as 演化而来,加入联邦协议后开源,强调稳定与易用。

    补充一点项目背景:它最初是一个叫 Write.as 的、注重隐私的简单博客平台。我们运营 Mastodon 实例有一段时间了,也一直关注 fediverse;今年夏天相关实现变得容易后,我们加入了 ActivityPub 支持(Mastodon、PixelFed、Funkwhale 等背后的协议)。fediverse 有很强的自由开源软件文化,所以发布 AP 支持后我就着手把 Write.as 开源,这就是最终成果。Write.as 已存在四年,应用代码非常稳定;现在我在把代码打磨到在任何配置下都能良好运行、易于安装。

    thebaer查看英文原文

    To explain a little more behind this project: this started out as a simple, privacy-focused blogging platform called Write.as. We've been running a Mastodon instance for a while and keeping up with the fediverse, so over the summer as it got much easier to implement, we added support for ActivityPub (the protocol behind Mastodon, PixelFed, Funkwhale, etc.) The fediverse has a strong FOSS culture, so after releasing AP support, I got to work on opening up the source for Write.as, and this is that final result. Write.as has existed for 4 years, so the application code is very stable. But right now I'm getting the code to a place that works great in any configuration, installs easily, etc.

    标语里的行话会劝退读者,写作要用受众能懂的词。

    你有没有研究过,你目标人群里的访客有多大概率能看懂这里的“federated”是什么意思?我这么问是因为它就在标语里:如果产品描述里有个关键词你读不懂,你大概就不太会再对这个产品感兴趣了。

    salvar查看英文原文

    Have you done any research into how likely it is that a visitor from your demographic understands what "federated" means in this context? I ask because it's part of the tagline, so if you don't understand a key word in the product description you're probably less likely to show interest in it.

    写作者需要低摩擦的发布与互动方式,工具链太复杂会让人放弃写作和回应。

    我喜欢这个想法,也很期待它流行起来。由此我有两个让我还没进入这个生态的疑问:一,我不想托管复杂的平台,我只需要静态生成的博客。ActivityPub 也许能让人在不放弃静态的前提下给我的文章留言,有集成 ActivityPub 的静态博客系统吗?二,有支持 ActivityPub 微博客的原生桌面客户端吗?我注册了 Mastodon 账号,但唯一的使用方式是用命令行工具发帖;对我来说它是只写的,因为我懒得开浏览器,能改变这一点会很好。

    rhn_mk1查看英文原文

    I like this idea, and I'm eagerly waiting for this to catch on. Following up from this, I have 2 questions that keep me from entering the ecosystem: - I don't want to host complicated platforms, all I need is a statically generated blog. ActivityPub could be the way to let people comment on my posts without forfeiting the staticness. Is there any static blog system that integrates with ActivityPub? - Are there any native desktop clients supporting ActivityPub (micro)blogging? I've set up a Mastodon account, and the only way I interact with it is posting via a command-line tool. It's write-only for me because I can't be hassled to use the browser, and it would be nice to change that.

    同类还值得读

    1. 我坚持每天写一条 TIL,已经写了一年

      Show HN: I've been writing daily TILs for a year

      这篇展示作者一年每天写 TIL(Today I Learned)并整理到 GitHub 仓库的做法。

      博客与个人写作2016 · 819 分 · 150 评4 条写作要点编辑精选
    2. 如何写出开发者愿意读的博客文章

      How to write blog posts that developers read

      这篇(正文与评论未提供,仅从标题判断)讨论面向开发者写技术博客的方法:怎样让忙碌的工程读者愿意点开、读下去并读到结尾。

      博客与个人写作2025 · 603 分 · 154 评4 条写作要点编辑精选
    3. 博客写作风格指南

      A blogging style guide

      这是程序员兼博主 Robert Heaton 的博客写作风格指南,用几十条简短规则讲如何让技术文章更清晰、更好读。

      博客与个人写作2018 · 495 分 · 188 评4 条写作要点编辑精选
    4. 十年职业博客写作,我学到了什么

      Ten years of professional blogging – what I’ve learned

      这是作者回顾十年专业博客写作经验的总结,评论补充了写作作为深度学习、聚焦主题、保护写作习惯和选择发布平台等实践。

      博客与个人写作2017 · 362 分 · 126 评4 条写作要点编辑精选
    5. 十年博客写作教给我的事

      What I learned in ten years of blogging

      这是一篇博客作者十年写作经验总结,核心观点是写作的价值在于持续积累而非单篇爆款。

      博客与个人写作2018 · 356 分 · 162 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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