撰写技术文章/博客 101 ✍
感谢@tringakrasniqi启发了我写这篇文章。😊
我写技术博客已经有一段时间了。这些年来,我学到了很多关于如何“在线”写作以及如何“技术性”写作的知识。一开始,我只是阅读或保存文章,但后来我萌生了与他人分享知识的渴望,于是在评论中写下“很棒的文章”、“我已收藏此文,感谢您的撰写”之类的话。后来,我突然有了灵感,就把它变成了我的第一篇文章。
这段旅程始于很久以前(4-5 年前)在我的 WordPress 博客上,我可以说,我在技术文章方面获得了如此多的曝光,现在我可以为其他人提供一些相关的建议。

以下是我推荐的 10 点要点:
1️⃣ 选择一个特定主题并定期撰写相关文章。例如,如果你对 React 感兴趣,无论你正在学习什么(技巧/窍门、新功能)或构建什么,你都可以写一篇关于它的文章来帮助别人。
2️⃣ 选择一些还没有文章或很少有人写过的主题,这样你的文章就能从最新的资源中受益,并变得独一无二。如果你的文章写得好,一段时间内,你的阅读量肯定会不断增长。
3️⃣如果你找不到任何新主题,或者互联网上已经有很多内容,那么尝试用你的方式来写。这可以包括你自己的写作风格,以一种有趣/有创意的方式解释概念。
4️⃣ 尝试引用你遇到的真实案例,使你的文章更具特色。例如:如果你处理了 React 的一个 bug,请添加一些截图、代码示例,并用通俗易懂的语言向大家解释你是如何修复的。
5️⃣ 使用简单的英语单词,尽量不要使用一些生僻的/随机的单词/短语。技术文章的目的不是教授牛津英语,而是指导我们,而指导可以用简单的英语词汇来完成。这样读者就不必离开你的文章去寻找特定的单词/短语了。
6️⃣尽量让你的文章时长在 5-10 分钟之间(以 DEV 和 Medium 中显示为准)。不要太长也不要太短。你肯定不希望读者只看到长篇文章的正文,然后就跳转到新标签页。
7️⃣ 使用Grammarly 扩展程序(或类似工具)来纠正标点符号,提高英语写作水平。这是一款很棒的工具。你也可以使用一个网站http://www.hemingwayapp.com/。
8️⃣ 你写的每篇文章都应该至少包含三个部分:引言、正文和结论。在三者之间留出一些空白,以便读者能够看到每个部分的起始和结束。
9️⃣在文章结尾,请务必告诉读者向他们发送反馈、添加评论、向他们询问参与问题(例如“您希望在这个项目中使用哪些其他 UI 库?”等)。
🔟 不要过度宣传。尽量不要说“拜托,拜托分享给其他人,关注我,订阅我的YouTube频道,关注我的Instagram”之类的……你懂的。喜欢你内容的人会分享和订阅,这很自然!
5 个额外提示💡
1️⃣很多人都知道这一点,但我还是要说:“别忘了给每篇文章都配一张好看的封面图片。” Unsplash、Pexels和其他一些网站都是很棒的资源。或者,你也可以用Canva自己制作封面图片!没有封面图片的博客文章会显得很孤单,也很无聊。
2️⃣ 尽可能引用他人作品并给予认可。例如图片、代码片段、引用等等。
3️⃣ 保持文本格式规范。使用符号、表情符号/GIF(但不要过度使用)、标题、引号、粗体和斜体等,使其更美观。尽可能使用项目符号。
4️⃣ 添加资源的超链接,例如,如果您使用任何外部库或软件,您可以添加其 URL。这样读者就无需再次搜索并离开您的文章。(“我使用Postman开发了这个 API”)。
5️⃣ 写你知道的,不要写你没用过的东西(或者假装读者不知道)。如果你没用过 Vim 编辑器,却仍然在写它,读者可能会在评论里问你“为什么这样,或者为什么那样?”,而你却无法给出明确的答案。接下来的后果是,读者可能再也看不到你的文章了!你可能会因此失去你的读者。
就是这样!😃
希望你理解了我的建议,并学到了一些新东西。下次你在 Medium 或 DEV 上写作时,请关注我分享的这 15 点,并在评论区告诉我我遗漏了哪些重要点。继续写代码,继续写博客!👨💻 ✒
每个#SoftwareDeveloper在其职业生涯中至少都会说过一次这句话。#DevHumour pic.twitter.com/lVr91U3FCr
— BeautifulBoy (@Prince_de_Love) 2020年2月28日