撰写技术博客 101

让我们做一个快速测验吧！

1. 你还记得薛定谔波动方程吗？
2. 你还记得迪士尼里头发最长的公主叫什么名字吗？
3. 你还记得青蛙的学名吗？
4. 你还记得公主和青蛙的故事吗？

是的，虽然我们在幼儿园时读过长发公主和青蛙的故事，但我们甚至不记得几年前学过的东西，这些东西对于我们通过考试、进入名校并让我们的父母感到骄傲至关重要！

我的朋友，这就是讲故事的力量。

无论你写博客是技术博客还是非技术博客，最终的目的都是讲述一个故事。这里有一些技巧和窍门，可以帮助你写出精彩的技术博文。

🏷️简介 – 做一个讲故事的人。用
Surface 设备产品来介绍你最喜欢的 Netflix 惊悚片——吸引你的是一个引人入胜的故事，比如一段 1 分钟或更短的视频。同样，当你写博客时，你需要一个故事大纲来吸引你的用户阅读到最后。博客的简介部分需要简短明了，大致涵盖以下三点：

✔️ 你为什么要写这篇文章——其背后的故事
✔️ 你将在这个博客中涵盖什么内容
✔️ 谁会阅读这个博客？

需要注意的是，一篇技术博客文章通常可以是一个人们可以一步一步遵循的教程，或者至少应该教一些有趣的东西

🏷️基础层 – 这是包含大量内容的层级。
上下文相关性 – 利用博客的这一部分深入探讨你在文章中想要关注的主题。在这一部分中，你需要构建一个完整的结构，包括步骤、相关代码片段、文档、架构/流程图以及其他相关文章（如有）的超链接。

我们需要注意本节中的三个主要要点——

✅ 标题
✅ 图片/视频
✅ 格式

一些可以帮助您塑造博客的工具/功能 -

☑️ Markdown – 如果您在 dev.to 上写作，请确保您熟悉Markdown 语法
☑️​​ Snagit – 可以帮助您为博客截取屏幕截图
☑️ 使用Cloudinary向您的博客添加和管理图像/视频
☑️ 颜色对比度分析工具 - 帮助将文本转换为背景颜色
☑️ 单词选择，例如单击而不是鼠标
☑️在图像上放置替代文本
☑️ 超链接短语或描述网站的单词，而不是说“这里”

注意：如果您正在为您的文章创建教程/演示视频 - 最好将其上传到 YouTube/Twitch 频道并将其链接到您的博客。

🏷️结论 – 宣传你的内容
这是比赛的最后一圈，需要付出不少努力。你可以采取以下措施来吸引用户访问你的博客：

✔️ 打包你的全部内容——为你的博客创建标题图片，并添加副标题
✔️ 在相关出版物上发布。例如，如果你正在撰写一篇关于使用 Microsoft Azure 认知服务的博客文章——你应该去 dev.to或Medium上的 Azure 出版物。✔️
社交媒体推广——在相关的 Facebook 群组/新闻通讯上发布推文/分享（如果可能）

撰写技术博客的核心目的是“帮助开发者” ——就像任何技术倡导者一样，帮助更广泛的社区。撰写社区所需的内容，解决社区亟待解决的问题，并持续按照社区期望的方式打造产品。这才是健康的 DevRel 🥑 应有的样子。不妨在dev.to上查看Microsoft Azure 出版物下的一些精彩博客。