这个答案由四部分组成：

  1. 博客的四种类型
  2. 不同文章类型的写作要点
  3. 如何写博客
  4. 如何收集写作的灵感

博客的四种类型

首先，我将技术博客分为下面几种类型:

  1. 技术细节型（Handbook）。频率: 每周多次，15~30分钟可以写完。
  2. 干货型（Article）。频率: 每月几次，1~2小时可以搞定。
  3. 实践总结型（Tutorial）。频率: 每周1～2次，2+小时以上的时间。
  4. 杂谈与鸡汤型（Essay）。频率: 每季度几次，少则几小时，动则上月。

博客的用户来源图：

image.png

前三者可以带来很多的流量，后者可以带来大量的评论啦。

前三者可以让你在Google上有一个好位置~~，后者可以让你在用户心中有个好位置。

通过社交媒体可以让第四种类型的文章，有大量的评论和转载。

干货型和实践总结型的文章通过聚合网站来传播的效果最好。

不同文章类型的写作要点

接着， 让我们再看看上面的几种类型：

技术细节型（Handbook）

这种类型主要来自于日常工作，但是好像写这一类的人不多。每天我们都会遇到不同的技术问题——如某个第三库更新，某个浏览器bug，如何使用某个技术。因此，我们就会用这样的关键字和词去搜索，反正大部分教程序员使用Google的文章就是这么写的。

既然你想要这样的搜索，那我就直接把搜索结果放前面好了，如：

  1. Mac OS Laravel 安装
  2. Homebrew versions安装特定版本软件
  3. brew versions gradle安装指定版本gradle

如果你也擅长用Google的话，我想你就懂了奥秘。标题的前半部分是关键字，后半部分指名意图。

接着，就是贴解决方案和代码咯~~。在这时候需要注意几点：

  • 试着去表达一些技术上的细节，也会省去一些技术上的细节。
  • 以自己学习的角度去想怎样写可以一步步下来。
  • 加入一点点自己的情感，博客和文档是不一样的。（详细见下文）
  • 编写更简洁的内容，因为技术博客与此文不同的是，技术博客是面向寻找信息的人。

干货型（Article）

一般来说，这种类型的文章更类似于GitHub上的那些Awesome类型的Repo。说说几个标题，大概可能就会有点感觉了：

  • 每个程序员必知之SEO
  • 作为一个前端工程师你了解你的小伙伴么 - chrome
  • App 上架相关事宜、解决技巧
  • 20 个非常有用的 Java 程序片段
  • Java 开发者不容错过的 12 种高效工具

通常来说，这一类型的文章都是作者一段时间对于某一个东西的总结，非常有收藏价值。故而，这种类型的文章会在GitHub或者聚合网站上比较受欢迎。所以，它也更容易传播。

但是写起来的难度比较大，这依赖于你的使用经验。所以，也不是一天、两天就能搞定的。

实践总结型（Tutorial）

看看标题，可能大家都知道这一类文章要怎么写了：

这通常是一系列的文章，而这一系列的文章一般是连续写出来的。也因此，我们可以发现很大的书都是由这一类的文章衍生出来的。

这一类的文章更像是干货型和技术细节型的结合，面向特定领域的技术，也属于干货。对于这种类型的文章来说，更依赖于代码——读者需要依据代码一步步往下深入。

所以在这一类型的文章中代码往往比较重要。

杂谈与鸡汤型（Essay）

来几一些标题：

  1. 为什么整个互联网行业都缺前端工程师?
  2. 程序员职业生涯中应该思考的10个问题
  3. 怎么减少编程中的 bug？
  4. 为什么大公司看起来都那么糟糕？

BlaBla，简单地来说这一类文章基本上是没有技术的，都是一些以理论为主的概括。同时，写这一类文章的时候，也意料着可能在某一领域有一定的水平——写出来才会有人看。而由于偏向理论，这一类文章看的人往往会更多，因为它并不倾向于使用领域特定的技术。

所以这种类型是受众很广的文章，并且也像鸡汤一样容易传播。同时，这种类型的文章，更依赖于社区媒体及聚合网站的传播。因为大部分情况下，用户不会这么去搜索文章的。

如何写博客

对于博客的内容来说，下面几点很重要哦：

  1. 标题、小标题。一个好的标题会带来更多的流量的。
  2. 内容。以代码为例的文章，最好有代码。代码可以放在GitHub上，一举两得。
  3. 图 —— 一图胜千言，如本文第一节中的框架图。，一个框架图可以省去你的很多话语。
  4. 排版，又可称为UI设计。基本的语法高亮要有，容易阅读也要有。最简单就是白底黑字。

标题——必须重要，类名

对于写博文的人来说，重点的是如何清楚的去表达他们的想法，标题算是其中之一，这个也就是为什么标题党成为了标题党，而《设计模式》成为了经典。刚开始学编程的时候，更吸引你注意力的可能是《72小时学会Javascript》，而不是《Javascript 权威指南》，兴许让你买前者的原因是因为你能看懂前者，而后者不仅看不懂，而且价格更贵。只是一年以后，《72 小时学会Javascript》被你扔到了垃圾箱，而《Javascript 权威指南》却放在了原来放那本书的位置上。你定义的类难道仅仅应该是class class1么？

小标题——地图，method

小标题有点类似于sitemap.xml，只是他就是站点地图，一点就到了相应的地方。他应该直接了解的说这是开始菜单，标题栏，菜单栏，而不应该是简简单单的第一章，如果你真是那样写的话，你写的函数想必是

1
2
def fun1
end

如果你写的是get_data那么，我想你的函数名应该和你的文章一样，告诉人们，你要的是get_data。所以不要吝啬你鼠标的一下，它可以承受上百万字的点击。如果因为那样坏了，你可以告诉我，我可以帮你免费换一个欧姆龙的微动，前提是你的鼠标可以换。如果是HTML那么应该是h2 h3，markdown也就是用得比较多的github上的README.md的##或者是###

内容——函数体

这里可不是让你用一个让人难以理解的Magic Number，你写得越复杂，别人看的时间就越久，通俗易懂，就是一个很好的开始。你可以把一个个复杂的方法分解出来，或者提炼函数，或者重命名。当你相信你看不懂你的文章，正如你看不懂你写的hello,world我想你是时候去重构你的函数了。

复杂的部分，就用段落来解决，一个函数如同一个段落只应该表达一个思想，太长了就如同这篇文章一样没有多少人会认真去看。你需要给你写的一个精美的代码加一个注释，所以你也需要给你复杂的地方加上个（PS）。

在编写内容的时候需要注意下面的几点：

  • 代码。必要的时候贴出代码，会是一种快速有效的方法，工作的时候是为了完成某个任务。
  • 列表。列表可以简明扼要的说明你想要表达的内容。
  • 图表。一张流程图可以说明程序的步骤，一个表格可以作好一个对比。
  • 标题。标题的好处，可以让用户快速定位，让用户找到想要的内容。
  • 链接。一个好的URL对于使用英文的人来说，可以利于SEO，对于中文，使用的人可以判断出文章的专业与否。

引言——README

我想都会去看的，无论是在破解软件的时候，还是github上面的项目。简单的说说，这篇文章是干什么的，这个程序是干什么的。 大家都会，不是么？

没有什么好写的？ 说说你是怎么开始编程吧，然后写在你的博客上，你会发现你会爱不释手的。

如何收集写作的灵感

下面是我最近在做的，感觉很不错，推荐一下咯：

一般是先有个论点，然后再论据，最后才写。

第一步，在平时把想到的一些能写的文章灵感用TODO的形式列出来，如我用的是“滴答清单”。下面就是我最近想写的一些文章的一些标题：

image.png

但是有一些还没灵感，只是想到了个大概——所以有的是只是一个标题。这些文章大部分都属于杂谈型的，想到什么就说点什么，但是会有个核心。

第二步，在平时偶然会有点灵感的时候，就用Flomo创建一个新的记事，稍微写几句，提醒一下自己咯。在这一步，相当于就是找一些论据来支撑自己的观点，等到这些观点差不多的时候就可以写了。平时遇到什么好的段落也会摘抄到Flomo里作为灵感的材料。

image.png

第三步，便是写。写的时候其实没有啥感觉。“编程同写作，写代码只是在码字”。

真正的想法都在脑子里，而不在纸上，或者IDE里。

所以，其实写代码的时间很短，真实长的是想出怎么写，文章也是如此。