前言

我们知道对于技术工作者来说,技术文章输出是一个非常重要的部分。在我司的晋升体系中也是一个必选项。

然而很多同学理解能力非常强,可以快速的掌握一门新的技术,却对于如何去写一篇技术文章没有思路,无从下手,笔者写公众号以来,发现写文章这件事情其实是有套路可循的,掌握了这个套路以后文章的产出不管是数量还是质量上都可以有一个比较大幅度的提升。

注重你的构思

每一篇文章都是一个产品,这个产品的灵魂在于你想要论述的某个核心观点,就像摄影一样,当你看到一幅很美的画面,想要拍下来的时候,最重要的一点就是你的照片想要讲述一个怎样的故事。然后这个核心观点可以借助某些修饰手段成为一个标题。

建议通过思维脑图来梳理构思你的文章。我觉得思维脑图最棒的一点就是可以帮助你查漏补缺、激发灵感,技术文章通常具备一定的逻辑性,思维脑图的树状结构可以帮助思维层层递进,同时发现逻辑闭环的漏洞。

文章结构

小篇幅、高浓度、成体系、有收益
我写技术文章大的方向上通常就是分为3个部分。
第一部分前言,简单讲解本篇文章的的核心价值和目的,
第二部分是核心内容,按一定的逻辑组织你的文章结构,
第三部分是总结,可以简单回顾整篇文章的核心产出,也可以添加一些补充信息。

开头决定了读者对于文章的第一印象

人都是有惰性的,技术文章通常枯燥乏味,你的文章要让读者完整的读完是一件需要功力的事情,所以最简单的方式就是一步一步的勾引,小步拿结果,那你的开头一定要“下药”,明确对其的价值,越生动越不需要动脑越有吸引力。

关键的核心内容

这个部分是文章的主要篇幅,最简单的套路就是“3W1H”分析法则,从what到how,从概念到细节,让读者能先对要讲述的内容有一个概括性的了解,然后再深入背后的细节完成实体的内容。

由于每个要论述的实体都会有一些其论述范围内的专有术语,即基本常识,因此你需要对基本的概念进行普及让读者先理解其基本环境,然后来讲一些核心概念。最后讲基本的操作及一些使用过程中会遇到的实用方法。

其基本套路就是:

  • 第一部分:技术的基本概念
  • 第二部分:技术的核心概念
  • 第三部分:技术的基本功能和实用方法
  • 第四部分:技术的高级实用技巧
  • 第五部分:总结 + 深入学习的资源列表…

结尾可以帮助读者得到更多的信息

技术文章的结尾一般都比较干净利落,可以回顾文章的核心产出,帮助读者宏观上把控文章的内容,加深你对他的洗脑。另一方面可以留下一些延展信息,给读者一些饭后点心,让他进一步加深对你的好印象~

合起来总结一下

  1. ### 前言
  2. 清楚讲解本篇文章的的核心价值和目的,
  3. 配以合理的介绍性的文字、图片、代码,甚至是 Demo
  4. 对整篇文章的结构大纲有一个概述性的介绍,为后面的核心内容做铺垫和准备
  5. ### 核心内容(多个)
  6. 可以讲讲本文所描述的主题相关内容:
  7. - 是什么?(What):这个技术是什么,它的历史介绍等
  8. - 为什么?(Why):为什么我们要使用这个技术,和其他技术之间的比较,延引相关技术内容
  9. - 怎样使用? (how): 如何使用这个技术,相关的配置项,使用方式等。
  10. - ...
  11. ### 总结
  12. 回顾整篇文章,对内容、核心产出、重点做一次总结
  13. 援引一些资源、开源库、书籍、文章链接,让读者可以继续学习
  14. 给读者以与作者继续保持联系的方法…

一些小技巧

这里给大家写文章的一些小点心:

  • 文章选题应简洁直接、直达主题
  • 一篇文章一般不要超过15个小节
  • 标题之间应连贯有逻辑,遵从一个大纲排布规则,可以通过思维脑图来进行串联
  • 每篇文章平均阅读时长在 10 分钟左右
  • 图片应该大小合宜且清晰,包含图片描述
  • 准确的代码区块,切忌大段粘贴代码
  • 内容排版中善用 h2、h3、blockquote、code、ul、ol 等元素
  • 在内容上多使用链接去援引外部内容