如何撰写有洞察力的技术文章

原文：towardsdatascience.com/how-to-write-insightful-technical-articles/

在这篇文章中，我讨论了如何撰写技术文章。我撰写这类文章已有大约 2.5 年，我将分享我的经验，如何找到自己的领域，以及在撰写文章时需要记住的事项。

这篇文章的目标是介绍技术写作以及不同类型的技术文章。此外，我还会讨论我从写作中获得的大量益处以及我从写作中学到的教训。

该信息图表突出了本文的内容。我将讨论撰写本文的动机、不同类型的技术文章、寻找自己的领域以及我从技术写作中学到的经验。图片由 ChatGPT 提供。

你还可以阅读我关于基准测试 LLMs 的文章，并查看我的网站，其中包含所有我的信息和文章。

动机

我撰写本文的动机是我已经撰写文章大约 2.5 年了。我决定反思一下我的写作之旅，以及为什么撰写技术文章是我职业生涯中做出的最佳决定之一。

深入学习主题：最好的学习方法就是教授他人。当你撰写技术文章时，本质上就是在做这件事。
建立人脉：你可以与许多阅读你文章的读者以及其他与你做同样事情的小说家建立联系。这既为你赢得追随者提供了机会，也为你从他人那里学习提供了机会。
货币化：如果你有足够的读者，写作也是一种经济上支持自己的方式，尽管我必须提前说明，这不应该是你开始写作的主要动机。

我认为学习主题的第一点比我从写作中获得的其他任何好处都重要。写作提供了一个途径，既可以教授他人关于一个主题的知识，同时也能进一步深化你对这个主题的了解。教授他人是自我学习最好的方式。

我发现，在写作教授他人的同时，通过写作加深对主题的理解，这是一种非常有益的经历。我真心认为这是实践技术写作最伟大的部分之一，也是我推荐您也写技术文章的一个重要原因。

技术文章的类型

“如何”… 编程文章
测试/报告新版本
讲解一个主题

这类分类突出了不同类型的技术文章。图由 ChatGPT 提供。

“如何”文章

一篇“如何”文章是一篇详细说明如何在编程中做某事的文章。它可以像如何利用特定的 Python 包那样具体，也可以像如何使用上下文工程那样模糊。这些就是我更喜欢写的那种文章，因为它们既符合我喜欢写的内容，也符合我想要写的内容。例如，我在项目中使用了一个新的框架，或者学习了某个主题（例如，上下文工程](https://towardsdatascience.com/how-to-significantly-enhance-llms-by-leveraging-context-engineering-2/)），然后写了一篇关于如何利用该框架或如何在主题中做某事的具体文章。

测试新版本

许多技术文章也专注于测试和报告新版本。最近，这些文章大多围绕测试新的 LLM 模型，如最近的 Qwen 3 版本或 Grok 4。我经常阅读这类文章，以了解 AI 领域发生的一切，并了解不同模型的表现。我也尝试过自己写这类文章，但我觉得有点单调。

讲解一个主题

另一种常见的技术文章是关于特定主题的教学文章。这些文章通常涵盖的范围比“如何”文章更广，但非常有帮助。这类文章可以是某个主题的入门文章，为经验丰富的读者提供深入的文章，或者介于两者之间的任何内容。我通常在接触新主题时阅读这类文章，或者为了保持对特别感兴趣的主题的了解。您应该注意，这些文章通常制作起来非常耗时，但它们往往是我在网上阅读的最高质量文章之一。

找到您的细分市场

写作时，找到您的细分市场至关重要。找到细分市场包括寻找以下类型的文章：

您喜欢写作（并且您擅长写作）
您的读者喜欢阅读

您的细分市场可以是超级具体的（例如，仅限 Python AI 教程），或者它可以撒得更广，例如“如何”教程的 AI。

此图突出了寻找你的细分市场。你的细分市场将是你喜欢撰写的文章类型和你的（未来）读者喜欢阅读的文章类型的组合。对我来说，我通过“如何”文章找到了它，涵盖了我所工作的主题：上下文工程、利用 OpenAI Whisper 或构建 RAG 系统。图片由 ChatGPT 提供。

要找到你自己的细分市场，我建议你尝试写我在上一节中列出的不同文章类型。最重要的方面是找到你喜欢写的内容。当然，这也可以随着时间的推移而改变。在找到你喜欢写的内容之后，你需要开始定期撰写文章。我大约每周写一次文章，我认为这是在持续在线分享我的知识的同时，避免因写作过多而导致的创造力枯竭的好平衡。

此外，我还发现，通常来说，写你有一些背景知识的主题要容易得多。例如，我主要写关于人工智能的文章，这是我全职工作中每天都在处理的内容。这为我提供了大量的背景信息，这对文章很有用，并为我提供了写作主题的灵感。

我的经验教训

每篇文章的改进

我在写作两年半的时间里学到了很多。我发现我的第一篇文章和现在的文章之间有很大的进步。我的目标始终是尝试为每一篇文章改进某个具体方面。这样，我可以在一系列文章中看到显著的进步。因此，我的第一个学习经验是尝试在每篇文章中改进某个方面。

理念清单

我文章的想法通常来自我所工作的主题，以及阅读 LinkedIn、X 和 Medium。然后我更多地了解这些主题，并为他们撰写文章。想法可能随时出现，无论是刷社交媒体还是散步时。因此，我建议保留一个你想要撰写的不同想法清单。我把这个清单保存在 Google Keep 中，这样我可以通过手机和电脑访问它。

当我周日坐下来写文章时，我可以从我的想法清单中选择一个。我发现这比现场想出一个写作主题要简单得多。

文章大纲

在我选择要撰写的想法之后，我为文章创建了一个大纲。我发现这使文章更容易阅读（内容更连贯），并且在写作文章时更容易有一个概览。我是通过首先写下文章中所有的标题和副标题来做到这一点的，然后再写其他内容。这有助于我确定文章中要包含和排除的内容，并使文章的线索更容易保持。你可以自然地添加或删除标题，但我发现最初写下所有标题使写作过程更容易，输出质量更高。

在写作时，我也尽量减少中断。例如，假设我在写作时想到一些必须包含在文章中的内容（例如，我想引用的文章）。在这种情况下，我在文章中写下“TODO 在这里找到要引用的文章”，然后继续写作。完成文章后，我然后回到这个 TODO 并完成任务。这样，您可以避免中断。我建议在写作时尽量减少中断次数，因为中断后再次进入写作节奏需要相当多的时间。将中断保持在最低限度可以使您成为一个更高效的作家，同时您还可以通过使用 TODOs 记住您需要做的一切。

清单

我还学到的另一个重要经验是，为每篇文章维护一个需要完成的清单。有许多不同的事情您需要记住去做，而简单地为每篇文章填写清单可以确保您记住所有内容。例如，我的清单包括：

添加特色图片、副标题、摘要、标签和分类
使用 Grammarly 检查文章的拼写错误
确保文章中的所有代码都有语法高亮显示
在 LinkedIn 和 X 上分享这篇文章
…

出版社

我还强烈建议为您的文章找到一个出版社。这可能是在 Medium 上的出版物或像 Towards Data Science 这样的独立网站。拥有一个出版社可以确保更多的人看到您的文章，这对于您写作时的动力以及尽可能多地向人们分享您的知识都是至关重要的。

继续写作

我真诚地相信，一致性是写作时最重要的因素之一。您应该找到一个您可以在一段时间内维持的具体间隔。这可能是一个月一次，一周一次，或者您喜欢的任何其他间隔。然后您应该尝试随着时间的推移坚持这个时间表，同时每次改进文章的一个元素。随着时间的推移，您会发现您的文章有了很大的改进，更多的人在阅读您的作品。

结论

在这篇文章中，我讨论了如何撰写技术文章。我讨论了您在网上可以找到的不同类型的技术文章，以及您如何在撰写时找到自己的细分市场。我相信写作提供了巨大的好处，不仅对阅读的人，也对解释主题的作者来说都是如此。这也是我多年来一直坚持写作的原因。最后，我还讨论了一些我从写作中学到的经验，例如保持一致的写作时间表，为每篇文章制定清单，以及寻找出版社。

👉 我的免费电子书和网络研讨会：

📚 获取我的免费视觉语言模型电子书

💻 我的关于视觉语言模型的网络研讨会

👉 在社交媒体上找到我：

📩 订阅我的通讯

🧑‍💻 取得联系

🔗 领英

🐦 X / 推特

✍️ Medium