我是如何写好一篇技术博客的

前言

很多同学的进阶都是从写文章开始的,没错,说的是我。

不可否认的是,好的文章能够帮助一些背景不那么出色的同学面试加分,好吧,也是我。

今天我来和同学们分享一下,如何去写好一篇技术文章。


是时候表演真正的技术了

目录

目录

一、写文章之前

1. 明确目标

我们写文章通常会有两种:

  • 分享:提供快捷通道面向有同样需求的开发者。
  • 复习:仅为了自己复习,我不建议将这类文章发表到博客平台。

为什么我不建议将复习的文章发表到博客平台上?

因为当我们阅读到这类文章的时候,有时不能够明白作者的意图,只有作者自己能懂,对于此类文章,我的建议是将他们放在笔记平台上,比如印象笔记

2. 明确类型

通常的技术文章题材有:

(1)技术介绍型

一般用来介绍最新新出的技术,比如 Android 中的 Android Jetpack 和 Flutter,风格有点类似于技术文档。在我们学习了某项技术,并有了使用的经验之后,就可以着手来一篇,它通常面向的是此类技术的小白。比如我的即学即用Android Jetpack系列:

《即学即用Android Jetpack - Navigation》

(2)技术深入型

这类文章通常是从原理的角度深入分析某项技术,面向的是想要进阶的一群人。比如郭神的:

《Glide最全解析》

(3)解决问题型

通常是遇到问题的解决方案,此类文章面向的是同样遇到此坑的开发者。

二、写文章之中

即使明确了写作内容,有的时候电脑打开了,还是不知道如何写...


除了菜什么都没有

1. 拟定标题

先从标题开始吧,有如下几个要求:

(1)标题不要太宽泛

比如你想写一个RxJava系列的文章,于是你定了一个《一文搞懂RxJava》,结果你就写了一个RxJava操作符怎么用,下面保准给你来个评论:???

如果实在想将标题定的宽泛些,那我们该怎么办呢?可以将文章写成一个系列,这样既可以保证每一篇的篇幅,让读者读的舒服,也可以实现自己的想法。

(2)不要标题党

看过很多标题党,比如(无意冒犯):《Java那么多锁,能锁住灭霸吗?》。

作为一个写博客的人,标题党确实用时一时爽,不过,如果文章的内容不能够让人信服,被拉黑也是再所难免的。

从短期来看,一个好的标题确实能提升阅读量,但是站在长期的角度,大家之后搜索出相关的锁文章,比起《Java那么多锁,能锁住灭霸吗?》,更愿意看到《Java中的锁[原理、锁优化、CAS、AQS]》。

所以,我们尽量选择一个简短的题目,并且要从题目中可以看出,我们要介绍什么知识。

2. 使用前言和目录

使用前言的意图在于告诉读者本文的大致方向,让读者读完前言以后就知道这篇文章适不适合自己。

如果可以的话,也可以用脑图制作一些目录,像本文中的目录。

这样,文章的脉络就一目了然了。

3. 列个提纲

最好举的例子就是介绍新技术的时候,比如介绍 Android Jetpack

  • Android Jetpack 是什么?
  • 为什么使用 Android Jetpack
  • Android Jetpack 对应哪些库,每个库具体的功能?

提纲写好了,就不至于文章写到一半写不下去了。

4. 写作手法

记得小学写作文的时候,老师经常念叨,如果不知道如何写作文,总分总就是一个很好的方法,比如说,我们去介绍某一项技术的时候,可以这么写:

  • 开头(总):这个技术是一个什么样的技术,可以给我们带来什么?里面的主要功能是什么?
  • 介绍(分):这个技术每项功能如何使用。
  • 总结(总):这个技术使用的优缺点,在具体的实践中如何帮助我们。

除了总分总,还有一种常用的套路是:

在文章的开始阶段先抛出问题,让读者去思考,接着,从回答问题的角度,如何去解决问题。类似的文章有:

《Android Bitmap的内存大小是如何计算的?》

5. 注意排版

一些同学的文章虽然技术深度达到了,但是排版却不尽人意,导致读者去阅读的时候一点阅读的欲望也没有。

如果你的文章有下列情形:

  • 总是出现大段大段的代码或者文字。
  • 使用几级标题全看心情。
  • 中英文处理起来不太好看。
  • ...

可以参看阮一峰的:

《中文技术文档的写作规范》

当然,写文章并非写技术文档,可以根据自己的需求做一些修改。

三、写文章之后

文章写完以后,别着急发表,因为我们还有一些事情要做。

1. 从读者角度阅读文章

现在忘掉自己是一个作者,把自己当做一个读者,一步步的阅读,看自己是否能够从这些文字中掌握到这些技术,假设不能,你就应该去思考如何完善这篇文章了。

2. 检查文章

错字、病句和英文单词是经常发生的问题,所以当我们写好文章以后,需要至少再读一遍去避免这些低级错误。

3. 美化文章

也许你已经对博客平台上样式产生了一些审美疲劳,没关系,掘金和微信公众号的 Markdown(MD) 格式都支持 html,帮助你的文章从外表给人一亮的感觉。

对于我这种前端菜鸡,html 写是不可能写的,有没有什么好的办法呢?当然有,可以借助一些第三方的网站,比如:Markdown Nice,它可以帮助你自动生成好一些美观的样式,之后CV到对应的博客的平台,本文就是这么操作的。

闲聊一下

如果你有关于写博客的一些好的小技巧,欢迎下方讨论。

最后说一下,我把Id改了,由原来的「TeaOf」改成了「九心」,为什么改呢?觉得 「TeaOf」这个Id不太好记,然后想改成「九五」,名字被注册了,最后随便输入一个字,变成了「九心」

文章引用:

《分享下写技术文章的思路》
《知乎:程序员怎样才能写出一篇好的博客或者技术文章?》
《如何写好一篇技术文章?》

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270