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

    博客与个人写作2013penflip.com

    Show HN:给写作者的 GitHub?

    Show HN: A Github for writers?

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

    导读

    这是 Penflip 的作者在 HN 上展示产品:一个把 Git 式版本控制带给写作者的协作写作平台。评论区最有价值的讨论在于质疑“Github for writers”这个定位——真正的编剧、小说家和诗人未必需要逐字提交与批注,工具其实更适合技术型协作文档。写作者可借此反思:写作工具的形式,会如何反过来塑造自己的写作习惯。

    关键词 版本控制协作写作目标读者写作工具

    可以直接用的写作要点

    1. 01

      先想清楚你的文字是写给谁看的:给技术同事写协作文档和给读者写小说,是两种完全不同的写作,文体与工具都要先定人。

    2. 02

      长文写作不必为每个标点都留一个版本,只在结构、观点或整段改写处留下节点,区分有意义的修改与无意义的微调。

    3. 03

      初稿需要不被打扰的私密空间:作家习惯在反复重写中成形,不必让编辑或读者看到每一次改动。

    4. 04

      写作形式会影响写作状态:Markdown 适合结构化技术文档,叙事类写作更需要所见即所得的即时手感。

    HN 评论精选

    “Github for writers”名不副实:作家按修订稿写作、需要所见即所得,逐字提交反而制造噪音,工具真正的受众是技术型协作者。

    听到“写作者”,我想到的是编剧、小说家或诗人。“Github for writers”这个说法有误导性,因为真正会用这个工具的人恐怕不是作家,而是需要协作写东西的技术人员——这对写博客或论文的人来说很不错。几点问题:1)作家是按修订稿写作的,不喜欢自己改的每个字都被编辑或制作方点评;2)作家不喜欢 Markdown,他们要所见即所得,单是这一点就让人觉得这工具是为技术人员做的;3)写长篇时,大量无意义的改动会混在一起,写小说时能在不同版本间切换是好事,但每个标点都来一次提交就太过头了。

    dylandrop查看英文原文

    When I hear "writer", I think of a screenwriter, novelist, or poet of some sort. "Github for writers" is misleading, since I think the people who would use this wouldn't be writers, but rather technical people who collaboratively write things. This is cool, given its audience is people who write blogs or possibly research papers. I think you showed this (or the premise of this idea) on HN a month ago or so. It still has the same problems as it does then... IF your core audience is still writers as defined above. 1) Writers write in revisions, and don't like to have every word they change critiqued by their editors/producers/etc. 2) Writers don't like markdown -- they want WYSIWYG. This feature alone makes me feel like your goal was to make this tool for technical people. 3) I think a lot of meaningless changes would get jumbled up in the mix if you're writing something long. If you're writing a novel, it would be nice to go between different versions of the novel, but perhaps a bit too much if you had a commit for every punctuation mark. This being said, I'm sort of interested what you think your audience should be. I think it could be a good tool given the right circumstances.

    同类还值得读

    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

    关注向阳乔木

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

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

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