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

    写作方法2015classeur.io

    Classeur.io:用 Markdown 重新享受写作

    Classeur.io: Re-enjoy writing, with Markdown

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

    导读

    这是一篇关于 Markdown 写作工具 Classeur.io 的讨论帖,评论者们从各自的使用经验出发,谈 Markdown 编辑器怎样才真正好用。对写作者来说,值得读的地方在于:这些讨论不只是比较工具,还涉及笔记之间如何互相链接、写作与阅读能否在同一空间完成、草稿怎样顺畅发布,这些都会直接影响你日常的写作与整理方式。

    关键词 Markdown编辑器写作工具笔记链接写作流程

    可以直接用的写作要点

    1. 01

      优先选择支持文档之间互相链接的工具,让零散笔记逐渐连成可检索的知识网络,而不是只写一篇篇孤立的文章。

    2. 02

      写作时尽量让“写”和“读”处在同一空间,比如逐行渲染或并排预览,减少在编辑器和预览窗口之间来回切换的干扰。

    3. 03

      挑选能同步到云端、一键发布到 GitHub 等平台的工具,让从草稿到成品的流程尽量短。

    4. 04

      长期项目(如研究日志)需要一个能随手附上截图、附件等素材的写作环境,素材和文字放在一起才方便日后回溯。

    HN 评论精选

    单篇编辑够用,但缺少文档间链接就无法支撑成体系的笔记网络。

    这些 Markdown 编辑器要想对我真正有吸引力,缺的是一种方便的文档间链接方式。比如 vimwiki 那样,把词或词组用 [[ ]] 括起来,它就变成一个 [[链接]]。这类应用编辑单篇文档很棒,但一旦你想建一个笔记本或一整套互相关联的笔记,就不行了。

    k2enemy查看英文原文

    The thing that would make all these markdown editors a killer app for me is an easy way to link between documents. Something like vimwiki, where you can surround a word or group of words with "[[" "]]" and it turns that word into a [[link]]. These apps are great for editing a single document, but fall down when you want to create a notebook or set of interlinked notes.

    同步与发布能力是编辑器的重要卖点,协作功能则是待补的短板。

    我最常用的 Markdown 编辑器是 StackEdit:可以把文档同步到 Google Drive、Dropbox,也能发布到 GitHub,很难被超越。不过 StackEdit 目前没有实时协作功能,所以我很好奇 Classeur 在这方面能提供什么。(后来我发现 StackEdit 和 Classeur 是相关项目,似乎都出自同一位作者。)

    nlte查看英文原文

    https://stackedit.io/ is my markdown editor of choice. You can sync your documents with Google Drive, Dropbox, publish to GitHub. Really not easy to beat, in my opinion. However, there's no live collaboration feature currently in Stackedit so I'm interested to see what Classeur has to offer in this respect. (Now I see that Stackedit and Classeur are related projects, apparently both authored by https://github.com/benweet).

    写作与阅读常在同一过程中发生,逐行渲染的一体化界面比分屏预览更贴合真实需求。

    我今天花了一个小时找笔记应用。多数 Markdown 编辑器的问题在于,记笔记的人很少在事后才去读笔记——我写和改的时候会读,但更多时候是在阅读或查阅笔记的过程中顺手修改它们。Mou、MacDown、Classeur 的做法是提供可切换或分屏的预览;Mac 上的 Notes.app 则让你在同一块空间里边写边读,可惜不支持 Markdown。也许我是特例,但我希望用 Markdown 写笔记、并让它逐行(或一次几行)渲染出来,这样只有一个文档,而不是一个编辑器加一个显示区。如果真有这种东西,我非常想要。

    vonklaus查看英文原文

    I spent about an hour looking for a note taking app today. The problem with most markdown editors is that the note taker rarely reads the note in absentia. I mean, I read my notes as I write them and edit them, but more often than not, I am changing them as I read or consult them. The mou/macdown/classeur approach is to have a preview that can be toggled or visible in split screen mode. Conversely, notes.app on Mac works really well and you can write and read notes on the same "space" but it doesn't support markdown. Maybe I am an edgecase, but I would like to write notes in markdown and have them render line by line[0] so that I have one document and not an editor and a display. Almost wrote one myself but the opportunity cost of spending weeks making it (if I could even deliver) would likely not offset the bit of frustration I get using another editor. If this exists, I want it bad. [0] or like 3 lines at a time or whatever.

    长期写作项目需要可嵌入截图与附件的开源方案,工具顺不顺手决定能否坚持。

    各位同行:我一直在找一套方案,能用 vim 配合 Markdown 标注来写个人(研究)日志,并嵌入多媒体(主要是屏幕截图),最好还能给笔记附加文件。当然希望是开源的。有人有类似需求或现成方案吗?我试过 Atom 加 vim 绑定插件和 Markdown 预览,但界面跟原生 vim 比还是不够顺手。如果你的配置接近我的需求,欢迎分享。

    an6n查看英文原文

    Dear fellow hackers, I've been looking for an application setup with what I could write my personal (research) journal using vim with markdown annotation and with embedded multimedia (screencaptures, mostly). It would be great to have a possibility to attach files to notes, too. Of course I would like the setup to be open source. Does anyone have similar needs and perhaps solutions for them? I tried atom with vim-bindings-plugin and markdown-preview but somehow the UI just didn't cut it for me when compared to a native vim. Please, share your setup if you have anything that resembles my need!

    同类还值得读

    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

    关注向阳乔木

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

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

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