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

    写作方法2020masteringemacs.org

    如何在 Emacs 中写一本书

    How to Write a Book in Emacs (2015)

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

    导读

    这是一篇 2015 年的实践文章,讲如何把 Emacs 当作写一整本书的写作环境:从结构组织、写作到导出成稿(如 PDF、EPUB)。对写作者的价值在于,它示范了如何用纯文本加轻量标记来管理长篇结构,让内容与排版分离;评论区还补充了模块化写作和可复现示例的思路。

    关键词 写作工具长篇结构纯文本写作模块化写作

    可以直接用的写作要点

    1. 01

      用纯文本加轻量标记写作,把排版交给导出工具,改稿时能专注于文字本身。

    2. 02

      把长篇拆成可复用的内容块(主题、小节),再按需组装成章节,避免重复写作。

    3. 03

      固定一套自己熟悉的编辑器与工作流,减少在工具之间切换带来的注意力损耗。

    4. 04

      写完先导出成读者实际阅读的格式(如 PDF)通读一遍,检验成稿效果。

    HN 评论精选

    把内容拆成可复用的块再组装成章节,是管理长篇结构的有效方法。

    我最近研究了一圈制作电子书的技术,发现 DITA 这个概念很有意思:先写可复用的内容块(叫 Topics),再把它们映射成章节,生成整本手册。DITA 本来是给技术手册用的,但我觉得把内容拆块同样适用于写书,甚至写博客。另外我试了 XMLmind 的 ebookc,能把一组 HTML 页面打包成 EPUB、PDF 等格式;和原文作者一样,我读电子书也更偏爱 PDF。

    emmanueloga_查看英文原文

    I recently explored a bit the (seemingly never ending!) landscape of ways to create ebooks. In the process, I found a number of technologies I did not know before: * https://www.dita-ot.org/ * http://projectmallard.org/ * https://www.xmlmind.com/tutorials/HTML5Books/HTML5Books.html I find the concept of DITA very interesting: to write reusable chunks of content (called "Topics"), that one can later map into chapters and sections to generate a whole manual. DITA is geared towards creating manuals, but got me thinking it would be a useful way of splitting content for books and even blog posts. Mallard seems inspired by DITA but more minimalist. Looks pretty cool if I was generating documentation for a software product. The last resource is what I will actually try [1]: "XMLmind Ebook Compiler (ebookc for short) is a free, open source tool which can turn a set of HTML pages into a self-contained ebook. Supported output formats are: EPUB, Web Help, PDF, RTF, WML, DOCX (MS-Word) and ODT (OpenOffice/LibreOffice)." Similar to the author of the OP, I also like PDF better than other formats for reading ebooks. 1: https://www.xmlmind.com/ebookc/download.shtml

    选对并长期固定一个写作工具,能支撑整本技术书的写作。

    我的《Powerful Python》就是用 Emacs 写的。简短地说:效果非常好。今天我想不出还有什么编辑器能让我写这种技术书。

    redsymbol查看英文原文

    I wrote Powerful Python in Emacs. In short, it worked great. Can't imagine choosing to write a technical book like that in any other editor today.

    工具选择可考虑能否让代码示例与运行结果自动同步,保证示例可复现。

    这跟 R 的 Bookdown 相比如何?Bookdown 除了常规的 Markdown 和 LaTeX,还能直接运行 R 代码,并把结果(表格、图表)嵌进书里。

    datashow查看英文原文

    How does this compare to R Bookdown ( https://bookdown.org/yihui/bookdown/ ), which can do the regular markdown stuff, plus LaTeX, and also run the R code and embed results (tables, plots, etc.) into the book?

    同类还值得读

    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

    关注向阳乔木

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

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

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