如何写一篇技术博客

谈谈我的看法

如何写一篇技术博客

一、如何写一篇技术博客

首先,我认为要把自己当做是一个分享者,而读者是一个小白。然后模拟这个场景:如果你要把你学习到的技术分享给小白,你需要怎么去做。

按照我的思路,我可能会这样做:

首先,这项技术是什么你得先告诉他。
接着,为什么要学习这项技术,学习了这项技术有什么好处。有没有以前的技术跟这个较为相似的,为什么我不用以前的,而要学新的。(这一步非常非常重要)
然后,这项技术的核心用法是什么,给出一些小案例,让小白体验到这项技术。
最后,用这项技术可能会出现什么问题,官方有没有提供方案解决,如果没有,可能的解决方案有哪些。
大白话来说,其实就是:

是什么
为什么
怎么做
一般来说,我会把重点放在 为什么 ,因为我一直认为学习一门技术一定得知道:为什么要学。

二、文章需要有自己的风格

每个人写出来的博客都有自己的风格。

比如说有漫画型的:

如何写一篇技术博客

比如说有故事型的:
如何写一篇技术博客
故事型讲解

比如说有骚气型的:

如何写一篇技术博客

比如说有纯干货型的:

如何写一篇技术博客

说了这么多,其实我想说的是:写博客应该要带有属于自己的风格。而不是把网上的资料直接复制粘贴就完事了,这样没有感情,没有灵魂。(当然了,如果网上可能的确有写得很好的,可以这么做,但不可能整一篇都是相同的嘛)

三、关于排版

一篇好的技术文章,它的排版一般不会差。我认为写技术文章有几点可以提高一下阅读体验:

整篇文章不要90%都是代码,适当减少代码,贴关键的部分就好了。(完整的代码可以上传到GitHub)
多分段,技术文章可能就相对枯燥,如果将技术的说明挤在一块,可能阅读起来没那么好的体验
增加图示说明 or 插入相关的图片
程序员写文章一般都用Markdown语法了,使用恰当的话,文章的排版自然也不会太差啦。所以还没用Markdown语法的同学可以赶紧用起来,这玩意特好学,从学到用起来就几分钟。

我当时连简历都是Markdown语法…

如何写一篇技术博客

四、关于工具

Markdown编辑器我推荐使用Typora,无论是在Mac还是在Windows上都很好用。使用Markdown就肯定要考虑一个问题:图床用哪家?

无论使用哪家图都有可能会挂,自己搞个图床可能会安全一些(相对来说会比较麻烦),我自己是使用掘金的图床的。而我的文章往往会分发到几个博客网站上,像简书/知乎这种会单独将图片上传到他们的服务器上。

所以,从我个人的使用角度而言,并不会担心图床会挂问题。如果你将文章只发送到一个平台中,还是得关注一下图床是否可能失效的问题。

如何写一篇技术博客

至于你发哪个平台,主流博客平台有以下这些:

掘金:https://juejin.im/timeline

开源中国:https://www.oschina.net/

知乎专栏:https://www.zhihu.com/

思否(SegmentFault):https://segmentfault.com/

****:https://blog.****.net/

博客园:https://www.cnblogs.com/

简书:https://www.jianshu.com/

慕课网手记:https://www.imooc.com/

腾讯云社区:https://cloud.tencent.com/developer

阿里云云栖社区:https://yq.aliyun.com/

51CTO博客:http://blog.51cto.com/

自己搭建:Hexo+GitHubWordPressGitHub/GitBook

具体怎么选择就看大家了~~~~~