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

    写作方法2010chrismdp.github.com

    我是如何用 Vim、Git 和 Ruby 写一本书的

    How I'm writing my book using Vim, Git and Ruby

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

    导读

    作者介绍了自己用 Vim 编辑、Git 管理版本、Ruby 写脚本的写书流程:全部以纯文本形式写作,再用工具链自动生成和转换格式。对写作者的价值在于它示范了「把写作当工程来做」的思路——让工具承担重复劳动,作者专注在内容上;评论区则延伸出一串同类替代方案。

    关键词 写作工具链纯文本写作版本控制格式转换

    可以直接用的写作要点

    1. 01

      用纯文本(Markdown/Org/LaTeX)写作,格式转换和版本管理都会轻松很多,不被某个编辑器锁死。

    2. 02

      用 Git 记录每一次修改,可以放心大改、随时回退,也能开分支试验不同的章节写法。

    3. 03

      把目录生成、格式转换、拼写检查这类重复劳动交给脚本,省下的注意力留给内容本身。

    4. 04

      选工具的标准是「减少写作阻力」,而不是追最新最酷的那一个。

    HN 评论精选

    推荐 Org-Mode:富文本、超链接、导出 HTML 与代码片段执行一体化。

    楼主显然很爱 Vim、Git 和 Ruby。我写文章时觉得 Org-Mode 非常好用:支持富文本、超链接,还能导出 HTML(带目录,并可引入自定义 CSS/JS),是个很不错的编辑器。如果你要写 Ruby 代码片段,Org-Babel 也相当好用。再次说明,我不是在挑楼主的工具组合的刺,只是想抛出另一个选择。

    raju查看英文原文

    It seems the OP likes his Vim, Git and Ruby. I have found Org-Mode to be very useful when writing articles. With support for rich text, hyper-links as well the ability to export to HTML (with a TOC, and the ability to pull in your custom CSS/JS files) it makes for a very nice editor. If you are doing Ruby code snippets, Org-Babel works pretty well too. Again, not picking on the OP's tool-kit. Figured I would throw out another alternative.

    一句话力挺 LaTeX 作为长篇写作的排版方案。

    LaTeX 是你的好朋友……

    Anon84查看英文原文

    LaTeX is your friend...

    推荐 glyph 这个面向书籍写作的工具。

    glyph(http://github.com/h3rald/glyph)看起来在写书方面很有前途。

    yatsyk查看英文原文

    glyph (http://github.com/h3rald/glyph) looks very promising for books writing

    Pandoc 以 Markdown 为源、可转成多种格式,是通用的格式转换枢纽。

    再抛一个选项:试试 Pandoc(http://johnmacfarlane.net/pandoc/)。用 Markdown 写,能转成几乎任何格式,用 Haskell 写的。

    zdw查看英文原文

    To throw another option out there, try Pandoc: http://johnmacfarlane.net/pandoc/ Uses Markdown, converts to everything, written in Haskell.

    同类还值得读

    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

    关注向阳乔木

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

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

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