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

    博客与个人写作2018vicarie.in

    用 Emacs 的 org-publish 写博客

    Blogging with org-publish in Emacs

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

    导读

    这篇讲在 Emacs 里用 org-publish 把 org-mode 文件发布成博客的实践。对写作者来说,值得看的是它把写作、结构化标记和发布流程串起来;评论还提到用 WriteGood 检查套话和重复表达。

    关键词 org-mode博客写作写作工具发布流程

    可以直接用的写作要点

    1. 01

      用 org-mode 写长文时,可借助定义列表、表格、脚注和信息框等标记把结构写清楚,而不是只堆段落。

    2. 02

      把发布交给 org-publish 这类自动化流程,能减少复制粘贴和手工排版,把精力留给内容。

    3. 03

      初稿自检时用 WriteGood 类工具标出套话词和重复表达,再逐处改写。

    4. 04

      若提供全文 RSS,要权衡读者阅读便利与每次更新全量重编译的时间成本。

    HN 评论精选

    推荐面向散文写作的 Emacs 主题,并提醒用拼写检查和 WriteGood 标记套话、重复表达。

    很棒!总能很高兴听到 Emacs 和 org-mode 的消息。对于在 org-mode/markdown 里写大量散文的人(或感兴趣的人),我今天刚发现的这个 Emacs 主题非常惊艳:https://github.com/kunalb/poet。最后别忘了 Flyspell 拼写检查,还有 WriteGood mode,它可以把套话词或重复表达列出来并在 Emacs 里加下划线等。

    globuous查看英文原文

    Nice ! Always great to be hearing about emacs and org-mode ! For those that write (or interested in writing) quite a bit of prose in orgmode / markdown, this emacs theme I just discovered today is mindblowing: https://github.com/kunalb/poet Finally, don't forget about Flyspell for spell checking but also WriteGood mode which allows you to list weasel words or repetitions and have them underlined by emacs amongst other things.

    org-mode 发布支持丰富标记和嵌入 HTML,但全文 RSS 的快速生成与全量重编译耗时是痛点。

    我为自己的网站做了类似的事(方法见链接)。到目前为止我觉得它是个相当好的博客平台。一大优点是它直接支持多种标记(定义列表、表格、脚注、信息框等),也容易直接嵌入原始 HTML(用于图表等)。但我一直纠结的一个难题是如何快速生成全文 RSS。我喜欢我的博客 RSS 包含全文(因为我也喜欢这样读文章),但 Emacs 每次更新站点都想重新编译每篇文章——这要花几分钟。

    pavpanchekha查看英文原文

    I do something similar for http://pavpanchekha.com/ (I describe the approach here: http://pavpanchekha.com/blog/org-mode-publish.html). I've found it a pretty good blogging platform so far. A huge plus is the diversity of markup (definition lists, tables, footnotes, info boxes, and so on) that are directly supported, plus the ease of directly embedding raw HTML (for things like diagrams and charts). But one challenge I've struggled with is how to generate full-content RSS quickly. I like that my blog's RSS includes the full blog post (since that's how I like reading posts) but Emacs wants to recompile every post every time I update the site—that takes minutes.

    移动端缺少好用的 org 编辑器,是采用 org 写作和知识管理的实际障碍。

    我采用 org 做发布和知识管理最大的障碍是 iOS 上缺少真正好用的 UX。有人知道其他支持 org 标记的 iOS 编辑器/应用吗?(发布本身在开发机上管理没关系)

    spac查看英文原文

    My biggest impediment in adopting org for publishing, and knowledge management is the lack of really good UX on iOS. Does anyone know of other good editors/apps on IOS that support the org markup? (I’m ok with managing the publishing itself on my dev machine)

    同类还值得读

    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

    关注向阳乔木

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

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

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