关于写作:如何写好一篇技术文章

40次阅读

共计 5301 个字符,预计需要花费 14 分钟才能阅读完成。

对于技术写作

周末读了张鑫旭大佬写的文章,感触颇深,记下随笔

引言

​ 写作真的是一个对职业生涯倒退很无益的事件,像什么呢,就如同英语和演讲一样,咱们即便不会,也能写进去优良的代码,也能升职加薪。然而如果咱们技术不错,英语流畅,不必我说,各位也都都能感知到益处之大。甚至说其作用不亚于咱们赖以生存的工程技术。从我这个一般学历一般开发的个体来看,写作的确挺难的,就像在写这篇文章的时候一样,我如同悟到了什么,想写点什么,然而下笔时确不晓得从何开始,在哪完结,更不用说把握文章让其领有清晰的脉络了。那么如何写好一篇技术文章呢,的确是个值得沉思的问题。本文从文章的题目、构造和内容登程摸索下如何能写出一篇好文章。

性情

​ 写作产出的文章格调,构造与内容暂且不谈,咱们来聊一聊性情,性情与写作有什么关系呢?拿我集体来举例,敏感型人格,闷骚。

我总结进去以下我写作时的心理状态:

  1. 这样写太普通了,有点丢人。
  2. 这个技巧不太常见,我写进去应该有很多人看而后因为这个关注我吧。
  3. 一个知识点,因为想解释的足够分明,写着写着越来越简短僵硬,想草草完结
  4. 我这篇文章被大佬看到了应该会被讥笑吧,技术个别也想炫技
  5. 我如同一个小丑🤡
  6. 这个中央应该放一张动图来解释更好🤔,算了,太麻烦了,还是贴张图吧
  7. 写完之后(有些文章):文档 / 论文式文章,毫无温度,写完本人都没趣味看,想了想,写都写了,还是收回来吧吧😂

​ 我以前不是这样的,刚上大学那会轻易拉集体过去都能砍大山一小时,更不会敏感,也不会闷骚,那会应该是真骚(bushi

​ 通过思考和总结,应该是写代码太久的缘故,在我的认知中大部分的程序员应该和我有差不多的性格特征,欢送👏各位探讨或者留下你写作时的心理状态,咱们吸取好的,改良坏的。

​ 话说回来咱们在不是议论写作吗,怎么聊到性情了,这是因为我感觉写好一篇文章的第一步就是扭转性情,看到这里很多观众就要大笑了,“江山易改,本性难移”,因为想写文章性情就要扭转性情,别在这扯淡了,然而我这里说的性情是写作上的性情,咱们能够通过心理暗示来扭转本人写作前的想法,写作时的想法,写作后的想法,比方:

  1. 他人可能没你想的那么厉害
  2. 世界其实就是个草台班子
  3. 纵情展现本人吧,你是个有温度的人,你的文章也应该有温度。
  4. 放弃高质量输入一段时间文章看看,不行就 崩 撤 卖 溜
  5. 我只和本人比,有提高就行
  6. 用心!

​ 对于第四点,其实是个悖论,如果能放弃一段时间高质量的输入,在这个扁平的互联网模式下,必定会有正向反馈的,所以也不会崩 撤 卖 溜了,这里想表白的是写作原本就是个低门槛,没有及时反馈的事件。所谓千军万马独木桥,紫皇宫阙路遥遥。激情磅礴兴致昂扬 ==> 三天打鱼两天晒网 ==> 铩羽而归点头撇嘴都是很失常的事件,如果为此为此内耗和焦虑,就得失相当了。

那么如何写好一篇技术文章呢?

麦克阿瑟说过:路选对了,就胜利了一半🥳。

抉择平台

​ 第一步要做的必定就是抉择平台。平台分为自建平台和公共平台

​ 自建平台就是咱们集体网站,如张鑫旭大佬的集体博客就是属于自建平台,自建平台主打的就是自在,轻易定制

​ 公共平台指的是:微信公众号、知乎、思否、InfoQ、掘金、medium、简书、csdn、b 站专栏、博客园、微博、头条号,百家号等,限度较多,然而平台能给你提供流量。

​ 如果是小白倡议先做公共平台,在公共平台上发表文章,多尝试不同的文章格调,确定有一个较高的浏览量的文章格调和内容之后在向自建平台引流。当然自建平台也能够作为你平时记笔记的中央。因为能够轻易定制,所以有很多程序员还是比拟喜爱自建平台的,自建平台也有一个益处就是它自身也属于一个作品嘛,面试的还是可能拿出来说一说的。

​ 当然还有一种半自建平台也是十分十分不错的抉择,如vitepress,WordPress,简略,疾速,逼格也不低,也是很多大佬的抉择。

平台总结:

​ 业余的技术文章举荐:知乎,思否,掘金、InfoQ,b 站专栏,微信公众号

​ 偏资讯娱乐浏览类的举荐:头条号,百家号,微信公众号

​ 如果写作倒退较好,公众平台和自建平台都是须要的,所以小孩子才做抉择,而小孩儿全都要。麦克阿瑟也说过:如果两条都走,那么定会胜利的!

确定主题

​ 接下来该写文章了,假设这里你才华平平,肚子里的墨水不多,技术也个别。那么祝贺你!你的竞争对手 90% 都是这样的人,你只须要晋升 1%,就站到了金字塔的上端成为那前 10%。

​ 是时候确定一个写作主题了! 不同的人有不同善于的事件(废话),但也有人喜爱写本人不善于的货色(较少),不论你是哪种人,对于写作的主题如何抉择,有这么几点倡议:

  1. 最好与本职相干

​ 写的文章与本职相干更容易能反馈到本职工作中,通常你会为了写一篇文章,消耗很多精力去查阅材料佐证,在这个过程中有助于咱们进步本职本职工作的能力,可能会用于我的项目总结汇报,公司技术分享,提出技术计划,而这些可能在某些方面帮忙咱们升职加薪,或者更好的跳槽,也可能是让咱们在寒冬中多了一分竞争力!总之互惠互利。然而也不尽然,此处应扬己所长,避己之短。

  1. 尽可能的垂直

​ 咱们个体的精力是无限的,然而社会的倒退十分迅速,在技术畛域中,入门教程,进阶教程不论是文章还是视频早已如过江之鲫,不可胜数,在网上看到了一篇还不错的文章在几天后,你能想起文章内容,然而能想起作者是谁吗?然而如果你在细分畛域中产生肯定的影响力,那就不一样了,以卡颂在 react 源码这个垂直畛域的影响力来举例,能够设想到这么一个场景:共事 A 给共事 B 解聊天想钻研下 react 源码,共事 A 给共事 B 说“看 react 我强推卡颂,我看过很不错”,共事 B 说”卡颂我也据说过,给我个课程链接我去看看简介和目录。”,这就是在细分畛域产生的心智垄断,具体能够看卡颂大佬的这篇文章。在垂直畛域的继续输入能让本人写文章的价值最大化。

​ 总之,写作的主题尽可能围绕这两点联合本人的专长选出来一个。

头像和名称

​ 确定好写作主题之后,那就关上平台网站,开始写作吧,是不是忘了些什么,作为一个要认真写作的人,头像和名称也是要思考下的,不能上来就是小张前端,小王后端,小李运维这种太随便的名字,头像也最好不要选一个很大众化的头像,因为这是要随着你始终走上来的,文章内容可能在变,头像和名称最好不要轻易变动,这也是算是你的辨识度。当初它们就是你这家一人公司的 logo 和名称,花点工夫好好抉择,好了,名称和头像整好了那就让他们全平台统一吧!

文章选题

​ 在抉择好了平台、头像、名称,写作的主题之后上面就开始选题了。选题这件事件对于大部分人来都比较简单,因为当你想写一篇文章的时候,你是曾经晓得了本人要写什么了。

​ 例 1: 当我在工作中遇到了一个辣手的问题,发现了这是 javascript 中继承的一个坑,你想写一篇文章进去,那么你的文章主题就是 我想写对于 javascript 中继承的知识点

​ 例 2: Typescript新版本公布,你想疾速出手,写了一篇对于新版本公布内容的文章,这种文章就算比拟个别也会取得很高的浏览量。那么你的文章主题就是 我想写对于 Typescript 新版本的内容

选题举荐:日常工作中的小技巧,小翻新;深刻了解 XXX,XXX 原理分析;体现技术深度的辣手问题解决;

​ 好家伙,搞了半天对于写作的内容是一点没说🤣,不要急,马上就开始了!在写作之前有一个小技巧分享给大家,在确定主题之后,咱们能够先在搜索引擎上搜寻对于主题的信息,查看对于该主题的文章,而后还能够问 chatgpt,让 chatgpt 化身该主题的 super 专家,让他帮你列纲要。然而须要留神的是,咱们不能齐全信赖 chatgpt,所以须要一点工夫去分别 chatgpt 给你信息的可信度,不过就算是这样,也能给你足够多信息的和注意事项了。

文章浏览量要害:题目

​ 题目就像一个人的表面,没人违心通过你俊俏的表面来理解你“乏味的灵魂“,当然如果你是马云那我置信会有不少人想去理解马老师乏味的灵魂的,在技术文章中,一些超级大佬写的文章即便题目再简陋,依然被视若瑰宝。然而很多 ”” 技术人员 ” 都没趣味或者没工夫去分享他们的常识。所以当你有写作的想法并稍作保持,那么其实就过滤掉一大批人了。吸引人的题目会更有可能让读者浏览、点赞或参加到文章中。

​ 言过其实,刻意鼓动情绪的文章题目并不可取,例如:《props 的含意无人解释分明,快去请尤玉溪公子》,《震惊,尤大看了我的 pr 居然流下眼泪》,这样的题目与文章内容通常迥异过大,应用题目将用户诱导进去,然而内容平平,其余的畛域不分明,然而在技术畛域中,读者通常会对文章的内容要求很高,他想看到乏味的内容,取得有价值的内容。写作是一个买方市场,你能够坑骗用户一次,然而也就这一次了。

那么怎么是一个好的题目呢?

  • 这里也有个小技巧,就是能够给这篇文章写 10 个题目,而后筛选进去最好的一个。

上面是写好题目的一些倡议:

  1. 题目和内容要有一致性,不要在题目中承诺某些货色,然而在文章中却没有做到。
  2. 在题目中最好蕴含具体的数字,具象化咱们想表白的概念,

    • 好的例子:我是如何通过写文章每月赚到 3000 元
    • 不好的例子:我是如何通过写文章赚钱
  3. 联合搜索引擎。

    • 搜寻与你写的主题相干的在搜索引擎中高排行关键字,你也加上,通过搜索引擎的起源会是很大一部分的浏览量。
  4. 擅用 chatgpt 进行加强
  5. 增加俏皮的表情符号🥳

​ 举个好例子:性能优化:我通过这个简略的技巧让网站首屏关上速度晋升 30%!。这里应用了数字将性能优化这个比拟“宽泛”的概念具象化,“简略”二字变向的设置悬念。

还有用疑问句式写题目也有很好的成果如:

  1. 为什么?[性能优化]:为什么这么简略的技巧能让网站首屏关上速度晋升 30%?
  2. 如何 / 怎么?[性能优化]:我是如何通过这个简略的技巧让网站首屏关上速度晋升 30%?
  3. 质问:[性能优化]:这些优化网站首屏加载速度的技巧你把握了几个?
  4. 比照质问:chrom 性能优化指标泛滥指标中为什么这个指标对首屏加载速度如此重要?

在漫如烟海的博客中,读者会通过题目来判断是不是值得点进去,花点工夫把握下这个入口节点吧。

文章构造

​ 经验了重重困难,咱们当初能够搭建文章的构造了,以我本人写文章的时候来举例,脑海里没有文章构造这样的概念,都是想到哪写到哪,只有每一段的逻辑偏离的不是很离谱,都不会刻意去修改。然而好的文章构造能更好的促成你的文风,进步你的辨识度。

我总结如下的根底构造(个别文章能够间接套):

  1. 简略介绍

    • 简略介绍也能够称之为引言,引言局部切忌不可太官网,如这篇文章咱们将介绍 xxx 知识点,1. 2. 3. 4…..,或者像这样:在这个疾速倒退的行业里 …. 这种通用的格调结尾,那么或者你会损失掉很多曾经点进来的读者。
    • 引言和题目差不多,尽量活跃一些,或者用诡计一些引起悬念。能够用数字阐明文章的重点,缩小读者思考工夫,也能够用疑问句进行自问自答的模式,让读者成竹在胸。
  2. 介绍和阐明

    1. 介绍和阐明是整个文章的根底,通常咱们会介绍文章主题的背景,知识点的基本操作。增加插图来减少文章的可读性。
    2. 文字保障前后连贯,内容重点突出。
  3. 理论案例

    1. 这是文章的外围局部,引言是压服读者开始阅读文章,介绍和阐明提供了背景常识,而理论案例是给读者带来价值的中央。
    2. 增加小标题来帮读者辨认到次要的局部,这里也能够尝试邀请读者去浏览你的另一篇与此内容相干的文章,一是体现你对该畛域的业余度,二是并不是每位读者都会读到最初,你能够试着在中途把读者导入的你其余的优良文章 / 视频中。
  4. 总结和扩大

    1. 总结的阶段你能够表白本人的观点,提出本人的认识,能够让读者引起探讨,每篇文章完结的时候最好都带有一句标识性的话,比方灰太狼的 ” 我还会回来的 ”,这对塑造咱们集体品牌很有帮忙。
    2. 总结这个中央很多人都喜爱加上链接或者二维码之类的,我认为最好不要,除非和这篇文章的分割度十分严密,对读者很有帮忙。

​ 以上只是大体的介绍了文章的一些根本构造,如果咱们没有特地好的点子,能够按这个模式来套。读者看的清晰,天然不会悭吝手中的额赞的。而且有些时候写文章想取得高浏览量的起因也不仅是咱们可能会取得更多益处,二是因为咱们在写作上投入了大量的工夫、经验,只是心愿人们浏览它而已。如果看到这里,请点个赞吧[比心❤️]。

配图

​ 配图很重要,所谓一图胜千言,文章中一大段一大段的文字,看了也没啥食欲,适当的减少配图不仅能够减少一些视觉抵触感,缓解读者的疲劳感,而且有些概念用流程图 / 代码贴图解释起来比文字太清晰了。

​ 截图工具:FastStone Capture(Windows)、iShot(OS X 零碎)、微信 /qq 自带的截图工具。

​ 绘制图形:figma.com/jam

总结

​ 写作其实没有固定的套路可言的,咱们其实平时能够无意识的注意下平台的文章热榜,看看这些热榜的题目、构造、配图,汲取他们的长处记录下来,本人平时在工作生存中产生的灵感肯定要记下来,这些灵感可遇不可求,缓缓的积攒下来必定会变成一个写作高手。而且最重要的一点是要用心,清晰的解释,正当的代码,用心做的代码 / 逻辑图片,读者不是傻子,他们会看到的用心,这比什么方法论或者套路都有用多了。写到这里,重复读了几遍,总还是感觉有很多中央写的不是很好,然而,写都写了,那就收回来吧🤣[狗头]

正文完
 0