如何编写一篇高质量的技术博文?

同样的一篇文章,很多人写出来可以收获很多读者,换成是你,有可能写出来的自己都不愿意去看(惨不忍睹)。

很多人说:“ 我技术很好,但就是不会写文章,或者写不好。”

  • 怎么增加博文阅读量?
  • 让博客排名靠前?
  • 如何写好一篇技术文?
  • 那么写作的技巧是什么?
  • 怎么才能套在技术类文章里面呢?

该怎么把重点描述出来让别人 GET 到重点。

  • 标题很重要
  • 考虑好关键字
  • 简介、描述
  • 技术内容怎么选定
  • 内容如何进行优化
  • 最终的排版设计

本文适合拥有一定知识和经验储备、想要通过学习写作技巧来优化自己的同学。学完本文,可以获得博客写作的系统性知识,有助于自己运营博客或写作。

<hr/>

否写过博文或对自己博文不满意

你是否写过博文或者是对自己写出来的博文不满意呢?

吸引别人进来看的,第一直观就是你的标题,标题怎么取?这很关键,你得考虑到 SEO、爬虫、还有要点重点是否都结合在里面,如果标题取得不够好,读者估计连点都不会点击进来。

比如你解决了一个问题是关于 Go 的,这个时候你如果直接写成 “我用 go 解决了 xxxx 问题” 这样是不够的,你得告诉读者和爬虫引擎,你是用了什么语言,带了什么标签,问题是什么,问题的描述不一定是要原样,你可以用夸张或者比拟的方法,比如 :

  • “Go 开发,困扰了半月已久的并发问题”
  • “Go 语言集成 reb 后无法解析 Mlib”
  • “来看大神 10 分钟解决 LayoutBorn 等系列问题”
  • “Python 不得不看的十大要点,必备”

可以看出,很多人带了语言在前面,那是因为第一搜索时可以被抓取到,另外,如果自己有多篇文章,可以取自己定义的一个 FLAG 作为开头,比如:

  • “Ruby To2 系列一”
  • “Ruby To2 系列二”
  • “Ruby To2 系列三”

取标题的关键在于你的知识点,是否直观的告诉别人你要描述的是什么。

摘要的重要性

标题有了,然后是你的描述(概述、摘要),每篇文章都有一两百字左右的摘要。

当然,不同的写作博客平台,摘要的字数可能限制不一样,自己先定义好一百多字,再填充进来,这样在所有的搜索引擎中都会突出重点描述,增加可浏览性。

其次,摘要不仅仅是给别人看的,也是给自己看的,可以把它看做是重点总结。

关键字

关键字是做什么用的?不是给读者的,是给搜索引擎的,如果关键字和文章内容非常符合爬虫规则,则会优先展示到首页或者更加靠前的位置。

标题、摘要、关键字的结合效果

很多人好奇,标题如果没取好,我的摘要没写好,关键字取好了也不行吗?

其实,三者都是必备的 ,类似于HTMLdesctitle

那自己搭建的博客要如何排名靠前呢? 这个下期再讲……

举个例子:最近在 Baidu 搜索 Jdom解析冒号属性的,搜索内容都是无果,要么就是改用 Dom4JXPATH 或者 jaxen的,后来直接去看DOM4J都是集成过JDOM,改思路去看了 Jdom 源码发现了NameSpace 的类,这样的话,这篇文章要如何让它排名靠前呢??

百度搜索:jdom 解析 xml 冒号 ,来看下效果图:
Jdom 解析冒号属性杜锦阳

内容选定后怎么抒写

这个和写作文言文是差不多的,应该说和撸代码是差不多的。

先确定好开头和结尾,把思路理清一遍,看是否清晰完整,文字先不用去想,先把你要解决的重点突出,先复制粘贴进去,代码格式编辑好,拿Linux的内容作为例子,复制的代码进去要设置好代码块的显示效果,如下图:
Linux 代码显示杜锦阳
代码是基础,设置好代码,你要告诉的读者是什么,直接文字简单的描述下,如果不设置代码的话,最好是要带上图片,效果图或者截图,截图里面可以圈出内容或者把文字写在里面,现在的截图工具都带有这个功能的,所以不需要担心是否需要使用到 ps-Photoshop 。

其次,你的内容里面,前后语句读起来要顺畅,主题要衔接贯通,不要中断内容的描述,这个如果自己把握不好的话可以找个人帮你阅读,如果别人简单的能看懂,那就说明这篇文章是 OK 的,如果别人觉得很乱,根本不知道讲什么,那这个时候就要去优化内容了。

内容优化

除了图文并茂以外,代码块尽量设置进去,为了让别人看和复制粘贴使用吧,开源精神总是要有的 ,特殊情况就设置进去,比如:

  • 项目组代码之类的就打上马赛克
  • 个人代码不愿意公开的就先改名称或者部分打上马赛克
  • 其它原因

看个人的选择,内容优化取决于你的 内容,这里分好几种情况,这里不作为叙述,有兴趣的可以加博主我闲聊,内容这一块的优化,简单的讲,就是先对应各自的领域,套用相对的格式去作为内容输出,这句话怎么理解,就是缩小内容的画面,把精致的内容作为简版输出。

当你想写好一篇文章时更需要这些技巧,比如公式的描绘

  • $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
  • $$x = \dfrac{b \pm \sqrt{2b^2 - 6f}}{2xb} -f { \pm 2xy} $$

表格的描绘:

name 价格 数量
java $99 599
ObjectC $99 687
Android $99 767
Python $99 654
IOS $99 635

绘画-设计图流程图等等:
设计图

图形:
xposed 注意的地方杜锦阳

套用链接:

《 花非花,物非物,AI 岂是池中物(人工智能篇)》

优化排版

如果你不擅长写问题或者懒得写,可以结合知识点来展示你想告诉别人的内容,比如以下文章:

文章简化效果如:

最后才进行排版的优化,也可以借助第三方工具,不过展示效果不太如意,所以最好准备两个浏览器进行测试,手机排版估计可以忽略,该空格的地方要空格,该换行的要换行,不要一句话连着写了一大段,也不需要太啰嗦,毕竟这是技术文章,会绘画的同学也可以自己画图来给别人看,同样也能达到知识点输出的效果。

以上是增加博文阅读量和写作知识点的总结。

zzz...有兴趣的可以加博主我闲聊...

<font color="red"> ||</font> 版权声明:本文为博主杜锦阳原创文章,转载请注明出处。

[help me with MathJax]


dujinyang
8 声望1 粉丝

我佛慈悲、度你成魔、佛不度我、又该如何?