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

    写作方法2018youtube.com

    写给写作者的 Emacs(2015)[视频]

    Emacs for Writers (2015) [video]

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

    导读

    这是一场 2015 年的分享,讲写作者如何用 Emacs(尤其是 Org Mode)搭建纯文本写作环境。它值得读,是因为评论里补充了不少可直接照搬的实践:花时间配置 capture 模板、用 pandoc 自动抓取文献信息、按输出文件类型切换模板。对想摆脱重型写作软件、追求可长期保存和可复现流程的写作者很有参考价值。

    关键词 EmacsOrg Mode纯文本写作写作工具链

    可以直接用的写作要点

    1. 01

      值得专门花一个周末把写作环境配置好,尤其是 capture 模板:灵感、待办、素材能一键归档,才谈得上长期积累。

    2. 02

      用纯文本写作配合 pandoc 这类工具导出,格式和内容分离,稿件可以随时换模板重新排版。

    3. 03

      为同一份内容准备两套模板(草稿版和终稿版),草稿阶段就自动去掉不必要的排版负担。

    4. 04

      把文献引用交给工具自动完成(如从 Zotero 抓取条目),写作时只专注句子,不让格式细节打断思路。

    HN 评论精选

    写作工具的价值取决于前期配置投入,capture 模板是长期写作的关键基础设施。

    那个视频帮我弄出了一套能真正用起来的 Org Mode 配置。值得花一个周末去设置,尤其是 capture 模板。

    JoshMnem查看英文原文

    That video helped me get Org Mode working in a usable way. It's worth spending a weekend on setting it up, especially capture templates.

    用构建脚本按输出类型自动套模板并自动生成引用,能把排版杂活从写作中剥离。

    我 Makefile 里这几行展示了两个我喜欢的技巧:一是用 pandoc 配合 Zotero 和 citeproc 过滤器,自动抓取引用信息;二是根据请求的输出文件名后缀来选择不同模板。当然,这些并不限于 Emacs。

    ehudla查看英文原文

    The following lines from my makefile illustrate two tricks I enjoy. %.pdf: %.text pandoc -F pandoc-zotxt -F pandoc-citeproc $< -o $@ %.draft.pdf: %.text pandoc -F pandoc-zotxt -F pandoc-citeproc --template=draft $< -o $@ (1) Automatically grabbing citation details from Zotero. (2) Using the extension of the requested output file to choose the appropriate template. Not emacs specific, of course.

    同类还值得读

    1. 被低估的工程技能:把文章写好

      Undervalued Engineering Skills: Writing Well

      这篇文章讨论为什么“写得好”是被低估的工程能力,以及它如何在团队协作、系统设计和职业发展中持续带来回报。

      写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选
    2. 每行只写一句话:让写作和修改都更轻松的排版法

      Writing one sentence per line

      这是 Derek Sivers 的一篇短文,主张写作时每行只放一个句子,而不是按段落排版。

      写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选
    3. 书面沟通是远程工作的超级能力

      Written communication is remote work super power

      这篇文章讨论远程工作中书面沟通的价值,评论区则补充了异步与同步沟通的适用场景,并提醒读者:备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。

      写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选
    4. 如何写出有用的文字

      How to Write Usefully

      保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式:有用≈重要×新颖×正确×清楚,任一项为零,整篇文章就等于零;他还主张敢下确定判断、删掉让自己心虚的句子。

      写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选
    5. 如何写得更清楚、想得更清楚,并学会复杂材料(PDF)

      How to write more clearly, think more clearly, and learn complex material [pdf]

      这份 PDF 讨论如何把文章写清楚、把思路理清楚,并用写作来学习复杂材料。

      写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

    觉得有用,请作者喝杯咖啡。

    WeChat

    关注向阳乔木

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

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

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