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

    博客与个人写作2022mataroa.blog

    Mataroa博客:为极简主义者打造的裸博客平台

    Mataroa blog – Naked blogging platform for minimalists

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

    导读

    Mataroa 是一个极简博客平台:没有广告和追踪,界面干净,让人专注写作。这条讨论里既有使用者的真实体验,也有一堆关于「工具该怎么配合写作」的具体诉求,值得写作者读。它提醒我们:发布形式和阅读体验,比如字体、订阅方式、公式排版,都会影响文章最终被读到的样子。

    关键词 极简博客写作工具RSS 与分发排版可读性

    可以直接用的写作要点

    1. 01

      选写作工具时先想清楚自己文章需要什么形式(图、公式、长文),别让平台限制反过来改变你写什么。

    2. 02

      发布后能不能被完整读到很关键:让 RSS 输出全文,读者才不必跳转、不必被导航和广告打断。

    3. 03

      排版就是阅读体验:默认字体过小、无法调整这类细节,足以让一个满意的用户彻底搬走。

    4. 04

      把「简洁到没有干扰」当成写作环境的标准,减少按钮和统计数字,把注意力留给句子。

    HN 评论精选

    RSS 输出全文能降低读者的阅读门槛,分享元信息则决定文章被转发时的样子。

    我注意到一个很好的细节:生成的 RSS 里包含完整的 HTML 正文。希望更多博客平台这样做,能给阅读器用户省很多事。另外建议给文章加上 Open Graph 元信息,人们总会想分享文章,一套好的 Open Graph 标签很有用。

    derekzhouzhen查看英文原文

    One nice thing I recognized is that the generated RSS feed contains full html text. I wish more blogging platforms are like this; save a lot of effort for feed readers. I'd also recommend to add open graph meta for the blog posts. Presumably people will want to share the posts somewhere; a nice set of open graph metas goes a long way.

    排版可读性上的小缺陷足以让满意的用户流失;而评论、订阅这类功能则始终是取舍。

    我曾很喜欢用 Mataroa,2020 年前后它是我找到的最公道、最省心的博客方案。后来还是搬走了,因为默认字体太小又改不了。现在我用 NFS 自己托管静态站,也常在「要不要评论和邮件订阅」之间摇摆。开发者人很好,我还用他们的源码学了 Django,很感激。

    alecst查看英文原文

    I was using and loved mataroa. It was the fairest, most painless option I had found for blogging (as of 2020.) I eventually switched away from it because the default font was small and I couldn’t change it. I wonder if this has been updated since. (At the moment, I’m hosting my blog as a static site with NFS. I go back and forth about wanting comments/email sign-up.) The developers were nice though, and I used their source code to learn Django. Really grateful.

    先确认工具能否支持你所在领域的排版需求(如公式),再谈简洁与否。

    不错,几乎就是我想要的:简洁、支持图片(我要放图表)、没有广告和追踪。但我想写光学方面的页面,需要用 MathJax 排公式,想知道在 Mataroa 上怎么用,或者请推荐支持 MathJax 的类似服务。自己搭静态站虽然诱人,但超出我的能力——我不是 Web 程序员,Mataroa 的简洁正合适。

    DarkSucker查看英文原文

    Nice. Almost what I want: simplicity, images (for plots), and no adds or tracking. However, I want to author pages on optics, and I want to use MathJax (https://www.mathjax.org/) for equations. Please let me know how I might use MathJax with Mataroa if I've misunderstood. Or, please suggest something similar that supports MathJax. Rolling my own static site (as many NH postings describe) is enticing but beyond my ability. I am not a Web programmer, and Mataroa's simplicity is perfect for me.

    同类还值得读

    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

    关注向阳乔木

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

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

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