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

    写作方法2022panwriter.com

    Panwriter:集成 pandoc 的免打扰 Markdown 写作编辑器

    Panwriter – Distraction-free Markdown editor with pandoc integration

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

    导读

    这篇帖子介绍了一款带 Pandoc 集成的无干扰 Markdown 编辑器 Panwriter,评论区围绕“为什么 Markdown 编辑器层出不穷”“什么才算真正的无干扰写作环境”以及不同工具之间的取舍展开了讨论。对写作者来说,这些讨论能帮助你想清楚自己到底需要什么样的写作工具,把精力从反复挑工具转回到写作本身。

    关键词 Markdown 编辑器写作工具无干扰写作工具选择

    可以直接用的写作要点

    1. 01

      市面上大量 Markdown 编辑器功能大同小异,与其反复比较,不如选一个顺手的马上开始写。

    2. 02

      真正的“无干扰”不是分屏预览,而是让编辑和预览合二为一(所见即所得或语法高亮),减少视线和注意力的切换。

    3. 03

      最简洁的工具往往最有效:纯文本编辑器加少量插件就能满足大部分写作需求。

    4. 04

      挑写作工具时留意它能否顺畅导出或转换格式(如 Pandoc 集成),这决定了文稿后续的可用性。

    HN 评论精选

    Markdown 编辑器高度同质化,多数只是在前端界面上做微小变化。

    为什么有这么多 markdown 编辑器?是不是有什么库或控件,大家都从它出发来解析和渲染 markdown,然后就变成了在前面加个 UI、加少量新功能的简单练习?我不理解为什么这么多人一直在做基本相同的应用,只是对编辑和查看这种相对简单的结构化文本格式做了细微变化。我记得 80 年代,Commodore、Apple、PC 系统上能找到很多变体的快速应用是食谱数据库,主要是因为那是个简单的练习。markdown 编辑器是不是今天的这种?

    porcoda查看英文原文

    Why do we see so many markdown editors? Is there some library or widget out there that everyone starts from to parse and render markdown, and then it just turns into a simple exercise of putting a UI in front of it and adding a tiny number of novel features? I can’t understand why so many people keep producing basically the same application with tiny variations to edit and view what is a relatively simple structured text format. I sort of remember from the 80s the quick and dirty app that you could find many of variants of for Commodore, Apple, and PC systems was a recipe database, largely because it was an easy exercise. Is the markdown editor todays version of that?

    分屏不算无干扰,编辑与预览合一的单窗口才更让人专注。

    我不认为分屏 MD 编辑器算无干扰。我的 markdown 编辑器需要是一个合并的编辑/预览窗口。要么像 Typora 那样的所见即所得,要么某种语法高亮。

    andix查看英文原文

    I wouldn’t consider a split screen MD editor distraction free. My markdown editor needs to be just one combined edit/preview window. Either with Typora like WYSIWYG or some syntax highlighting.

    最简洁的工具(vim)反而最无干扰,强大与简单可以兼得。

    我的无干扰 Markdown 编辑器是 vim。没有 UI 杂乱,不是 electron 应用,加载超大文件超快,需要时强大,不需要时简单。我用 Goyo 只是为了限制列宽的便利,但真的这就是我需要的全部。

    approxim8ion查看英文原文

    My distraction-free Markdown editor is vim. No UI clutter, not an electron app, loads ginormous files super quickly, is powerful when you need it to be and simple when you don't. I use Goyo for the minor convenience of limiting the column width, but really it's all I need.

    Panwriter 与 Ghostwriter 各有取舍,带 Pandoc 集成的跨平台写作工具越来越常见。

    “无干扰”这点让我想起几年前用过的类似工具 Ghostwriter。据我所知两者的区别:Pandoc 作为转换器在 Ghostwriter 中只是可选的,我不知道它集成得如何;半官方的 MacOS 支持——Ghostwriter 需要你从源码构建应用,而且显然有些怪癖;更成熟的 Ghostwriter 有更多功能。无论如何,很高兴看到这个领域有更多选择,几年前跨平台的带 Pandoc 支持的 Markdown 文字处理器还很罕见!

    neitsab查看英文原文

    The "distraction-free" bit reminded me of a similar tool I used a couple of years ago, Ghostwriter [0]. Differences between the two AFAICT: - use of Pandoc as a converter is only optional in Ghostwriter, and I don't know how well it is integrated - semi-official MacOS support: Ghostwriter requires you to build the app from source (maybe its authors didn't want to notarize the app?) and it has a few quirks apparently[1]. - more features for the more mature Ghostwriter. In any case good to see more choices in this space, cross-platform Markdown word processors with Pandoc support were a rare occurrences a couple of years ago! [0] https://github.com/wereturtle/ghostwriter [1] https://wereturtle.github.io/ghostwriter/download.html#macos edit: formatting

    同类还值得读

    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

    关注向阳乔木

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

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

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