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

    博客与个人写作2021writefreely.org

    WriteFreely:搭建属于你自己的网络写作空间的开源平台

    WriteFreely – An open source platform for building a writing space on the web

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

    导读

    这篇帖子介绍开源写作平台 WriteFreely,主开发者与用户围绕它的定位展开讨论:核心只做写作、保持简单,把 newsletter、评论等功能作为可选模块;评论还延伸到自托管体验,以及写作平台更本质的问题——读者互动与内容发现。对写作者来说,它值得一读,因为它提醒我们:工具应服务于写作本身,而不该反过来分散注意力。

    关键词 写作平台个人博客专注写作内容发现

    可以直接用的写作要点

    1. 01

      让写作工具和流程保持简单,把注意力留给文字本身,而不是复杂的功能和配置。

    2. 02

      主动远离社交媒体式的提醒、信息流和点赞机制,为自己留出无干扰的写作空间。

    3. 03

      写完不等于结束:考虑评论互动和内容被发现的方式,才能让写作真正触达读者。

    4. 04

      不必依赖复杂的博客服务,静态生成、专注内容往往已经足够。

    HN 评论精选

    自托管用户不必为用不上的功能付费;对多数写作者来说,简单的静态生成已经足够。

    我自托管过一段时间的 WriteFreely,但发现很多功能是专有的,只在付费托管版(write.as)提供。那些功能我并不太需要,也能绕过,但这让我对这个项目挺不满的。自托管的人不太可能和愿意付费托管的人是同一批人,所以对他们锁功能没什么道理。我 fork 了代码库自己加功能,因为即便把用户引向商业版,他们进行的开发还是很少——看看我提交的一行 PR 花了多久才被合并。现在我只用一个简单的 Python 脚本就能做出博客所需的一切(Markdown、资源、MathJax、Atom feed,完全静态、无 JS)。没必要用复杂的博客服务,编译成静态 HTML 就够了。

    x4e查看英文原文

    I self-hosted a writefreely instance for a while but I found many features were proprietary and only available in the paid managed hosting (write.as). All features that I didn’t need that much and could workaround however it just made me feel quite dissatisfied with the project. People self hosting are not likely to be the same people who would pay for managed hosting so it makes no sense to lock features off for them. I forked the codebase and added stuff myself for a while because even after funnelling users to their commercial option they still do hardly any development, see how long this one line PR I made took to be merged: https://github.com/writefreely/writefreely/pull/429. Now I just have a simple python script that makes everything I need in a blog [0] (markdown, resources, mathjax, atom feed and all completely static with no JS). There is no need to have complicated blog services, just compile static html. [0]: https://github.com/x4e/Blog/blob/master/make.py

    项目刻意保持“写作”核心的简洁,把其他能力做成可选模块。

    我是 WriteFreely 的主开发者,很乐意回答任何问题。说说项目现状:我们刚发布了 v1.0 前的最后一个更新,目标是今年晚些时候发布 v1.0。在 1.0 中,你会看到许多我们一直在托管服务 Write.as 上试点的功能,包括 newsletter、社交媒体交叉发布、电子书导出等。我们也在试验新的非核心功能,比如图片托管和评论。我们的核心始终只是写作,所以很多功能(包括 ActivityPub 带来的功能)都被有意排除。我们想看看,在保持干净简单的核心、周围环绕可选的功能“房间”时,能做到什么。

    thebaer查看英文原文

    Hi! I'm the lead developer of WriteFreely -- happy to answer any questions you have! For a little update on where the project is today: we just put out our last update [0] before v1.0, which we're aiming to release later this year. In 1.0, among other things, you'll find many features we've been piloting on our hosted service (Write.as), including newsletters, social media cross-posting, eBook export, etc. We're also experimenting with new, non-core features, like photo hosting [1] and comments [2]. Our core focus has always been on just writing, which is why many features (including ones afforded by ActivityPub) have been left out. So we're trying to see what's possible when we keep a clean, simple core with optional "rooms" of functionality around it. If you want to keep up with us, you should see more developments around this before the end of the year, too. [0] https://blog.writefreely.org/version-0-13 [1] https://snap.as [2] https://remark.as

    远离社交媒体干扰、回归个人博客,是值得写作者投入的方向。

    引文说网络上有太多地方专门抢占你的注意力,让你不停滚动、刷信息流、盼着新的点赞或转发;WriteFreely 让你重新拥有独立思考的空间,远离提醒、信息流和传统社交媒体的干扰。我认为十年内我们都会回归博客、个人网站,抛弃社交媒体。让人搭建自托管博客越容易,这个转变就越快。我知道大众根本不在乎这个,但总可以抱有希望。

    quaintdev查看英文原文

    > There are enough places on the web built to hog your attention; keep you scrolling and checking your feed, hoping for a new like or retweet. WriteFreely gives you the space to think for yourself again, free from alerts, feeds, and the distractions of classic social media. I think within a decade we all are going to come back to blog/personal sites and ditch social media. The easier we make people to set up self hosted blogs, faster will be the switch. I know general public does not give a shit about this but a man can hope.

    写作平台真正的挑战是读者互动和内容发现,而不只是写作本身。

    在网上写作本身不是问题,用静态生成器建博客很容易,如今这类工具多的是。我认为真正的问题是,你想和读你文章的人互动。没有评论系统,写作、发布平台会失去很多潜在价值。另一个问题是别人也提到的“发现”。以 YouTube 为例:理论上你可以自己做视频并发布在自托管网站上,但发到 YouTube 上,被人发现的机会更大。所以要想赋能一个由个人网站组成的分布式网络,你需要一个强大的“索引”引擎,持续抓取并编目所有人发布的新内容,方便发现。还有一个问题是发现模式和消费模式之间的断裂:在 YouTube 上找到喜欢的视频,旁边还有相关推荐;如果索引服务把你重定向到实际托管内容的网站,一旦进入那个网站,你就不再在索引服务上发现新东西了。

    hsn915查看英文原文

    I think writing on the internet is not a problem. It's easy to build a blog from a static site generator. There are tons of them these days. IMO the actual problem is you want to interact with the people reading what you write. Without a commenting system, the writing/publishing platform loses a lot of its potential value. The other problem like other people mentioned is discovery. Let's take YouTube for an example. In theory you can make videos and publish them on your own self-hosted website. But if you post the videos to youtube, you get a bigger chance of people finding out about you. So, if you want to empower a distributed network of personal websites, you also need a powerful "indexing" engine that continuously fetches and catalogues all the new content being published by all these people for easy discovery. The other problem is discontinuity between discovery mode and consumption mode. On YouTube, when you find a video you like, you still see related or recommended videos on the side. If you have a video index that tries to work like YouTube but redirects to different websites where videos are actually hosted, you get this discontinuity where, once the user visits the actual website where the content is hosted, they are no longer discovering new things on the indexing service.

    同类还值得读

    1. 我坚持每天写一条 TIL,已经写了一年

      Show HN: I've been writing daily TILs for a year

      这篇展示作者一年每天写 TIL(Today I Learned)并整理到 GitHub 仓库的做法。

      博客与个人写作2016 · 819 分 · 150 评4 条写作要点编辑精选
    2. 如何写出开发者愿意读的博客文章

      How to write blog posts that developers read

      这篇(正文与评论未提供,仅从标题判断)讨论面向开发者写技术博客的方法:怎样让忙碌的工程读者愿意点开、读下去并读到结尾。

      博客与个人写作2025 · 603 分 · 154 评4 条写作要点编辑精选
    3. 博客写作风格指南

      A blogging style guide

      这是程序员兼博主 Robert Heaton 的博客写作风格指南,用几十条简短规则讲如何让技术文章更清晰、更好读。

      博客与个人写作2018 · 495 分 · 188 评4 条写作要点编辑精选
    4. 十年职业博客写作,我学到了什么

      Ten years of professional blogging – what I’ve learned

      这是作者回顾十年专业博客写作经验的总结,评论补充了写作作为深度学习、聚焦主题、保护写作习惯和选择发布平台等实践。

      博客与个人写作2017 · 362 分 · 126 评4 条写作要点编辑精选
    5. 十年博客写作教给我的事

      What I learned in ten years of blogging

      这是一篇博客作者十年写作经验总结,核心观点是写作的价值在于持续积累而非单篇爆款。

      博客与个人写作2018 · 356 分 · 162 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

    觉得有用,请作者喝杯咖啡。

    WeChat

    关注向阳乔木

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

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

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