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

    写作方法2021wereturtle.github.io

    GhostWriter:一个免打扰的 Markdown 编辑器

    GhostWriter is a distraction free Markdown editor

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

    导读

    这篇介绍的是 GhostWriter,一款免费开源的 Markdown 编辑器,主打无干扰写作。评论区顺势聊开了同类写作工具(KeenWrite、iA Writer、Emacs 写作配置)的取舍。对写作者来说,值得读的地方不在软件本身,而在于它反映的一个问题:工具设计如何影响专注力和长文写作的一致性。

    关键词 写作工具专注写作Markdown编辑器

    可以直接用的写作要点

    1. 01

      选写作工具时优先看它能不能减少干扰:全屏、隐藏工具栏、只显示当前段落,都是为了让你把注意力留给句子本身。

    2. 02

      写长文时,人物名、颜色、术语这类重复出现的元素可以先统一定义、再在正文中引用(KeenWrite 的变量思路),避免前后不一致。

    3. 03

      用纯文本 Markdown 写作,内容不被某个软件绑死,十年后还能打开和迁移。

    4. 04

      把写作环境和通讯、浏览器等分开,专用工具或专用的 Emacs 配置都能帮大脑快速进入写作状态。

    HN 评论精选

    专注模式加舒适配色能降低写作时的视觉疲劳和分心。

    另一个好用的编辑器是 iA Writer,它的专注模式和配色都很舒服、护眼。

    underseacables查看英文原文

    Another great editor is iA Writer which has a wonderful Focus Mode and a color scheme that is rather pleasing and easy on the eyes.

    用变量统一管理重复元素,能保证长文档里名称、颜色等前后一致。

    作者推荐自己的开源编辑器 KeenWrite,特点是可以在正文里使用外部定义的变量,变量还能用在图表、R 表达式和 TeX 公式里;变量支持嵌套插值,比如一处定义调色板,图表和最终 PDF 排版都能共用,角色名也能在正文和图表中统一引用。

    thangalin查看英文原文

    My free and open-source KeenWrite text editor is comparable to GhostWriter: https://github.com/DaveJarvis/keenwrite#features What sets KeenWrite apart is the ability to use (externally-defined) variables within the prose, shown in this older demo video: https://www.youtube.com/watch?v=u_dFd6UhdV8 Also, variables work in diagrams, R expressions, and TeX equations. For example, take a look at the following screenshot: https://raw.githubusercontent.com/DaveJarvis/keenwrite/master/docs/images/screenshots/05.png The palette is defined in one spot, allowing colours to be used by both diagrams and typesetting the final PDF. Further, character names can be assigned and referenced within both the prose and diagrams. Also, the variables are interpolated, which allows variables to be defined in terms of other variables. Are there any other text editors that have interpolated variable references? (I looked, but didn't find any, so started developing my own text editor.)

    成熟编辑器可以通过插件组合出适合自己的专注写作环境。

    喜欢 Emacs 的人也能搭出类似的写作环境:nano-emacs 提供干净的外观和默认配置,olivetti 营造专注写作环境,fountain-mode 写剧本,org-sidebar 做侧边栏,markdown-mode 带预览,org-mode 则什么都能干。

    podiki查看英文原文

    Looks nice! And I don't want to always be that Emacs guy, but for anyone interested, you can (of course) have a similar setup, here's some packages: https://github.com/rougier/nano-emacs (haven't tried, but clean look and defaults) https://github.com/rnkn/olivetti (writing environment) https://github.com/rnkn/fountain-mode (screenplay writing) https://github.com/alphapapa/org-sidebar (sidebar) https://github.com/jrblevin/markdown-mode (markdown, with preview too) https://orgmode.org/ (of course, org-mode for everything)

    同类还值得读

    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

    关注向阳乔木

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

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

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