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

    博客与个人写作2016github.com

    Openblog:用 GitHub Issues 写博客

    Show HN: Openblog – Blogging with GitHub Issues

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

    导读

    这是一个把 GitHub Issues 当作博客发布系统的开源小工具:每篇博文就是一个 issue,读者在 issue 下留言就相当于文末评论区。对写作者的价值在于,它把“写作—发布—讨论”压缩到同一个界面里,几乎零成本、零配置,特别适合用极低摩擦的方式维持持续写作和读者反馈。

    关键词 写作工具GitHub Issues低摩擦发布博客

    可以直接用的写作要点

    1. 01

      把草稿直接写在 issue 里,省掉打开编辑器、建文件、部署这一串步骤,摩擦越小越容易保持更新频率。

    2. 02

      让评论留在原文正下方,读者的讨论会变成文章的一部分,反过来给你下一篇的选题和论据。

    3. 03

      把内容(issue 文本)和呈现(静态站点生成)分开,换主题、换平台时文字不会跟着一起报废。

    4. 04

      用 issue 的标签、开放/关闭状态来管理选题库和已发布文章,写作流程本身就是可检索的。

    HN 评论精选

    这套方案的实际约束:内容存在 issue 里,迁移和分享会比存在文件里更麻烦。

    我的博客(pwmckenna.net)就是同样的思路。但我遇到的问题是:别人 fork 仓库后并不会把 issue 一起带过去,所以分享起来比我原先想的麻烦——你得为代码和 issue 各建一个仓库。源码在这里:github.com/pwmckenna/til

    pwmckenna查看英文原文

    My blog (http://pwmckenna.net) is built on the same idea. The issue I ran into is that forks don't have their own issues, so its a bit harder to share than I originally thought (you need a seperate repo for the code, and for the issues). Here's the source: https://github.com/pwmckenna/til

    读者希望讨论和正文并排出现,而不是分成两个页面。

    这主意太棒了。能不能把评论也直接内联显示在正文里?

    prezjordan查看英文原文

    Wow what a great idea. Would it be possible to list comments inline as well?

    更常见的折中方案:正文照旧用静态文件写,只把评论区交给 Issues。

    我想弄清楚它相比用 GitHub Pages 托管普通博客到底好在哪?后者的文章至少在仓库里能直接看到。如果只是为了给 GH Pages 博客加评论,我自己写过一种做法:用普通的 Jekyll 站点托管在 GH Pages 上,再从 Issues 拉取评论。链接:seanlane.net/2016/Hosting_comments_within_issues_on_Github_Pages/

    seanlane查看英文原文

    So I'm trying to understand the benefits behind this as opposed to using a normal blog hosted with Github Pages? Then the posts would be visible in the repo. If it is for having comments within a Github Pages blog, I found a solution that I wrote about myself about using a normal Jekyll hosted on GH Pages that pulls comments from Issues: http://seanlane.net/2016/Hosting_comments_within_issues_on_Github_Pages/

    GitHub 的附属功能(issue、wiki)都能被改造成写作与发布工具。

    我从没想过把 issue 用在这个地方。我之前写过一个用 wiki 的 Jekyll 插件 Jekyll-Gollum(github.com/rubyworks/jekyll-gollum),不过很久没维护了,现在大概需要有人接手修一修。

    transfire查看英文原文

    Never considered using the issues for this. I did create a Jekyll plugin for using the wiki: Jekyll-Gollum (https://github.com/rubyworks/jekyll-gollum) Haven't messed with it in a while though, probably needs some love by now.

    同类还值得读

    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

    关注向阳乔木

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

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

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