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

    写作方法2010orgmode.org

    Emacs Org-Mode:笔记、项目规划与写作

    Emacs Org-Mode: for Notes, Project Planning, and Authoring

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

    导读

    这篇是 Hacker News 上关于 Emacs Org-Mode 的讨论:它既能记笔记、做项目规划,也能直接用于写作和成稿。对写作者来说,值得读的是其中关于「如何组织笔记与任务」的经验:纯文本的便携性、层级结构的必要性,以及搜索与链接对长期写作的支撑。

    关键词 笔记管理纯文本任务规划写作工作流

    可以直接用的写作要点

    1. 01

      用纯文本加一致的符号前缀(如 TODO、子 TODO)记录任务与笔记,比花哨的工具更便携,也更易在杂乱内容中检索。

    2. 02

      笔记要按层级组织(主题—子主题、任务—子任务),扁平的单层列表会让想法和素材难以管理。

    3. 03

      为笔记建立方便的搜索与链接机制,写作时才能快速调用旧素材、把零散想法连成线索。

    4. 04

      选择能跨平台、可导出、便于他人协作的笔记方式,才撑得住长期写作项目。

    HN 评论精选

    嵌套的任务层级是真实需求,组织层次对笔记与写作规划很重要。

    这和我业余慢慢做了一个月左右的项目很像:bulletxt.com。它目前通过浏览器会话保存笔记,但我正把它做得像 pastebin 并加账号系统,会很像典型文本编辑器,能拖拽排序任务、复制粘贴、分享任务子树。我很怀疑 emacs 那类用户最终会用我的应用,但看到不止我一个人需要组织嵌套 todo 列表,感觉很好——我怎么也想不通大家怎么能忍受只有一层的任务列表。

    chime查看英文原文

    Wow. That's similar in vein to the project I've been working on slowly on the side for about a month now: http://bulletxt.com - it currently saves your notes via browser session but I'm working on making it like pastebin and having an account system. It'll be very much like a typical text-editor with the ability to sort tasks via drag-drop, copy-paste, and share task subtrees. I highly doubt the emacs-type will end up using my app but it feels good to see I'm not the only one who has a need for organizing nested todo lists. I can't for the life of me figure out how everyone can deal with 1-level deep task lists.

    笔记系统若缺少协作、搜索和便捷链接,就难以长期支撑写作。

    我很喜欢用 org-mode 记个人笔记,但有几个问题希望改进:一是外部协作,怎么让我的项目经理和我一起在 org-mode 文档上工作,最好能像 ikiwiki 那样在网页编辑和 emacs 编辑之间来回同步;二是搜索,理想情况下它属于协作的一部分,目前 Spotlight/rgrep 还行但不够好;三是更简单的链接与文件创建,希望吸收 VoodooPad/Tomboy 的思路,方便新建文档并链接过去,我已经用 ido-completion 做了文件链接快捷方式,但希望它能成为核心功能。

    zacharypinter查看英文原文

    I really enjoy using org-mode for personal notes. However, there's a few general issues I'd like to see improved upon: * External Collaboration (how can I get my PM to work with me on org-mode docs?) - Something like ikiwiki that works back and forth between web edits and emacs edits. * Searching - Ideally, this would be part of the external collaboration piece. Spotlight/rgrep is ok for now, but not great. * Easier linking/file creation - I'd love for org-mode to incorporate some of ideas/features in VoodooPad/Tomboy for easily creating new docs and linking to them. Could probably hack something together (and I have made a shortcut for file-links that uses ido-completion), but it'd be nice for this to be a central focus.

    纯文本加一致的符号标记最便携可靠,胜过花哨工具。

    说来奇怪,一个简单的文本文件一直能满足我对 TODO 列表的需求,甚至能放下与 TODO 相关的笔记和其他信息。它不好看,但我能在杂乱的文本里轻松找到 TODO,因为我坚持用左侧的「TODO 行开头」和「子 TODO 开头」符号。有时我也觉得有个整洁漂亮的 TODO 程序会不错,但我发现自己更看重文本文件的便携性——iPhone 上的 Notes、Mac 的 txt、Linux 的 txt、Windows 桌面的 txt 都能用。

    lqdshadow查看英文原文

    It's strange, but a simple text file always served my needs for TODO lists, even including notes and other information related to the TODOs. It is not pretty, but I do not have trouble finding my TODOs amidst the rest of the noise, since I am consistent with my left-side "start of a TODO line" and "start of a subTODO" symbols. Sometimes I think that having a neat, pretty TODO list program would be nice, but I learned that I find my text files much more portable (Notes on iPhone, a txt on Mac, txt in linux, txt on my Windows desktop).

    同类还值得读

    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

    关注向阳乔木

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

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

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