如何能让技术人的写作能力快速提升,甚至让人眼前一亮呢?下面分享一些技术文章写作经验,按照下边五个步骤,就可以快速写出80分的文章啦。
一:端正心态
很多IT人常以理科生自居,认为自己没有写作天赋,其实写作和编程一样,都是可以学习的科学。
另外还要克服技术人鄙视写作技能的脆弱内心,正视写作的价值。
二:明确读者
比如,你的目标是小白用户,他们可能连 Node.js 都没有安装过,你上来就让他们配个 webpack 以达到什么目的,这多半是没什么指望了,你就得先告诉他们如何去安装 Node.js。
但如果你的文章面向的是更深层次的探讨和分析,为了这部分小白用户去增加篇幅大可不必,只会让那些中高级程序员觉得这篇文章废话连篇,原本的价值大打折扣。
实际上,一篇文章不可能面面俱到,所谓《从入门到精通系列》,即使是书,都是为了照顾新入门的准开发者们从零基础开始的,涵盖不了精通所需的很多东西。
三:起好标题
也许你听说过这个说法:标题是文章最重要的部分,严肃的作家花在标题上的时间和写文章的时间一样长。确实如此,因为选好标题不仅是选择文章切入角度的第一步,也是让我们能够牢牢抓住文章主题而不至偏题的护身符。
你要清楚,在任何一次沟通过程中,大多数的人都只对某一条信息感兴趣,因此一定要保证你提供给读者的信息只有这些能引起兴趣的事情。
四:简介与大纲
技术文章的一大特点是文章逻辑严密,层级分明。因此在写作之前,应先列好提纲,根据内容层级由浅入深。
如果是长文的话,最好先写个几百字的简介再列提纲,还要搭建框架。这样能把文章范围圈住,不容易跑题。
文章内容的范围不宜过大,写大而全的东西对作者的水平要求非常高且需要消耗大量精力。如果真想写,也请先把思路理清,与有经验的人交流之后再下笔。
五:具体写作
对于初学者来说,写作时容易跑题、枯燥、没有重点,这时候可以尝试提问与问答模式。
提问与问答模式
像知乎和百度问答里的文章就是经典的提问与问答模式文章。这种模式的优点很明显,首先,因为文章是用来回答问题的,不容易写跑题;其次,可以很好地把目标用户吸引过来;最后,读者很容易能抓住文章的要点和逻辑,阅读起来更轻松。
讲故事的方法
如果你能够逻辑清晰、主次分明地完成一篇文章,也可以选用其他模式来写,这里比较推荐讲故事的方法,用叙事的方式来讲述专业知识,更具温度和亲和力,让读者能轻松地读下去。
段与名
当然,你也可以选择适合自己的模式,无论什么模式一定不要写太长段落和句子。每个段落只讲一件事情,每句话不要超过40个字,能用短句不用长句。
特殊文章
另外,类似选型、对比、趋势一类的文章,对行业整体的把握也非常重要,在表达自己的观点之前,应该充分了解其它人的看法,尤其是和自己观点相左的看法。
代码与demo
大部分技术知识可以用代码讲清楚,那么此处务必贴出代码。代码应该结构清晰,逻辑简单,能讲清楚问题就好了。一些关键代码需要有清晰的注释。如果有 demo,可以放上 demo 的链接。
术语与配图
在对高深内容或者细节进行描述时,即使前文已对相关名词做出了解释,也不应该堆砌专有名词。尽量用白话或者类比的形式将问题解释清楚,文字叙述不清楚的地方,请作图。
总的来说,一篇优秀的技术文需要有:
• 取好标题,醒目突出中心
• 图文并茂,适当配图说明
• 篇幅适宜,不宜过短也避免冗长
• 格式统一,基本排版规则需要遵守
• 细节处理,错别字标点处理正确。