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

    写作方法2022sive.rs编辑精选

    用纯文本文件写作

    Write plain text files

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

    导读

    这篇文章主张用纯文本文件写作:不依赖任何特定软件,几十年后依然能打开,还能借助 git 之类的工具记录全部修改历史。对写作者来说,它提醒我们关注一个容易被忽略的问题——你的文稿是否被某个软件绑架;同时也给出了更轻、更可控的写作与存档方式。

    关键词 纯文本版本控制Markdown写作工具

    可以直接用的写作要点

    1. 01

      把稿子存成纯文本或 Markdown,你就不必为了打开它而依赖某个特定软件或订阅服务。

    2. 02

      用 git 管理文稿版本,每次修改都有记录,再也不用命名成“终稿最终版v3”。

    3. 03

      Markdown 兼顾纯文本的可读性与标题、列表等结构,日常写作足够用;只有需要复杂排版(如浮动图层、批注箭头)时再用 Word。

    4. 04

      写作工具要按用途分层:构思与长文用纯文本,图文混排的成品再导出为 docx 或 PDF。

    HN 评论精选

    用 git 管理文稿,可以替代混乱的“终稿v3”式命名。

    纯文本还有一个好处:版本控制。你可以把写的东西提交进 git,得到完整的修改历史。这是程序员习以为常的事,但如果在技术圈之外被更广泛地采用会很棒——像“报告 终稿 终稿 最终版 v3.docx”这样的文件名多到惊人。“万物皆可 git”轻松能做成一家十亿美元级的创业公司。

    imgabe查看英文原文

    Another advantage to plain text files: source control. You can check your writing into git and get a history of all your edits. It’s something programmers take for granted, but it would be amazing if this got more widely adopted outside of tech. The number of files with names like “Report Final Final draft v3.docx” is truly staggering. “Git for everything“ would be a multi-billion dollar startup easily.

    Markdown 加本地文件夹可以在不牺牲功能的前提下避免被软件锁定。

    这正是 Obsidian 的主要优势,我最近一直在用,非常满意:所有内容都只是磁盘某个文件夹里的 Markdown 文件,完全没有被锁定的风险。你可以自建目录层级,也可以只靠搜索找到内容;搜索对我够用,需要额外处理时直接 grep/sed/awk 就行。它还提供了纯文本编辑器没有的功能:显示图片、实时预览、笔记之间的关联,甚至有 Vim 模式。

    elteto查看英文原文

    This is one of the main strengths of Obsidian, which I have been using lately and I’m extremely happy with: everything is just Markdown files in some folder on disk. Zero danger of lock in. You can have a disk hierarchy if you desire, or trust that search will find you what you are looking for. For me search works fairly well and if I need something extra I can just grep/sed/awk. Plus it has the features that a simple text editor will not have: displaying images, live preview, relationships between topics, etc. It even has a Vim mode!

    纯文本并非万能,复杂排版场景下成熟的商业软件仍有不可替代的价值。

    虽然我因为这些理由刻意避开了 Evernote 和 Notion,但我对 Microsoft Word 没意见。我用了二十年,它甚至能打开我 1980 年代 DOS 版 WordPerfect 的专有 .wp 文件。有时我需要更灵活的字体和图形排版,那就用 Word,Markdown 不是替代品——它的能力不足以支撑我要写的文档类型,比如 Word 可以把箭头、标注框作为可编辑图层浮在截图上。我相信几十年后我仍然能用它;就算微软变得不友好、只提供云端 Office 365,我也继续用 Word 2019,或者用 LibreOffice 打开 docx 作为备选。

    jasode查看英文原文

    >If you rely on Word, Evernote or Notion, for example, then you can’t work unless you have Word, Evernote, or Notion. You are helpless without them. You are dependent. Although I deliberately avoid Evernote and Notion for those stated reasons, I'm fine with Microsoft Word. I've been using it for 20 years. It even opens my proprietary DOS WordPerfect ("*.wp") files from 1980s! Sometimes I need more flexible layout of fonts and graphics and MS Word is the tool I use for that. Markdown isn't an alternative. (EDIT add: Markdown isn't powerful enough for the style of documents I write. E.g. MS Word has tools to overlay graphic elements like arrows and callouts floating as editable layers on top of screenshots. Markdown can't do that.) I'm confident I can still use it as a tool decades into the future. Even if Microsoft became more user hostile and eliminated local install in future versions and required a cloud-only Office 365 account, I'll just keep using Word 2019. LibreOffice may also be a Plan B option to open docx files. Not nervous about MS Word files at all.

    同类还值得读

    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

    关注向阳乔木

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

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

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