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

    博客与个人写作2012gist.io

    Show HN:gist.io,为黑客打造的无博客写作方式

    Show HN: gist.io, blogless writing for hackers

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

    导读

    这篇 Show HN 介绍 gist.io:一个让程序员无需自建博客、直接用 GitHub Gist 发布可读文章的极简写作工具。讨论涉及字体排版对阅读体验的影响、平台设计应保持中性,以及用 fork 原文的方式组织回复。对写作者而言,可从中借鉴“内容优先、版式中性、引用原文再回应”的发布与讨论思路。

    关键词 极简写作排版字体引用回复写作工具

    可以直接用的写作要点

    1. 01

      发布文章时把排版当作阅读体验的一部分:通用写作平台宜选经典、节奏匀称的衬线字体,避免字体风格抢走内容注意力。

    2. 02

      回复他人文章时,先保留原文再在上方写回应,并利用版本/fork 列表组织讨论,让读者能对照阅读。

    3. 03

      写作工具应尽量中性,不让界面“说话”,把表达留给文字本身。

    4. 04

      极简发布方式能降低博客搭建负担,先专注把内容写出来,再考虑评论、索引等平台功能。

    HN 评论精选

    字体选择会显著影响阅读体验,通用写作平台宜用经典匀称的衬线字体,避免设计抢戏。

    这个工具看起来很棒,但我必须对你的字体选择提出异议。虽然 Google 字体数据库把它描述成一款为阅读优化的获奖文学字体,但它夸张的衬线和不够均匀的节奏给人一种中世纪/启蒙手稿的感觉,显得不合时宜且奇怪。对于一个与 GitHub 集成、本不应在设计上“表达”什么的一般服务,我会推荐更经典、节奏匀称的衬线字体,比如 Minion、Caslon、Palatino、Baskerville、Hoefler Text,甚至 Georgia,它们在 14-16px 下阅读效果相当好。当然,我是设计师,仅因字体选择我个人就不会用这个服务;它与我系统上和常用网站上其他一切的中性风格冲突太大。

    msutherl查看英文原文

    This looks really great, but I have to take issue with your choice of typeface. While the description in the Google font database makes it out to be an award winning face for literature optimized for reading, its exaggerated serifs and uneven rhythm give it a kind of medieval / enlightened manuscript feel that just seems anachronistic and weird. For a general service that integrates with Github and shouldn't really be 'saying' anything with its design, I would recommend a more classic, rhythmic serif face along the lines of Minion, Caslon, Palatino, Baskerville, Hoefler Text, or even Georgia, which reads quite well at 14-16px. Granted I'm a designer, I personally wouldn't use this service based on the typeface choice alone. It just clashes too much with the neutrality of everything else on my system and on websites I use commonly.

    引用/保留原文再写回复,并用 fork 列表组织讨论,能让回应与原文对照、形成评论串。

    好东西。我看到一个很好的用例:当人们想回复一个帖子时,可以直接 fork 原来的 gist,并在上面写回复,像这样:http://gist.io/3140173。这样,你可以把 gist 页面右侧的 fork 列表看作评论列表(截图:http://cl.ly/image/1803161N432H)。

    melvinmt查看英文原文

    Great stuff. I see a great use case for this: when people want to write a reply to a post they can just fork the original gist and write their reply above it, like this: http://gist.io/3140173 In this way you can regard the list of forks at the right of the gist page as the list of comments (screenshot: http://cl.ly/image/1803161N432H).

    同类还值得读

    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

    关注向阳乔木

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

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

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