【全方位解析】如何写好技术文章

本文涉及的产品
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
全局流量管理 GTM,标准版 1个月
云解析 DNS,旗舰版 1个月
简介: 技术成长:相对于庞大的计算机领域的知识体系,人的记忆还是太有限了,而且随着年龄的增大,记忆同样也会逐渐衰退,正如俗话所说“好记性不如烂笔头”。并且在分享博客的过程中,我们也可以和大神交流,进而发现自己的认知错误,纠正知识体系。最后最重要的就是通过记录博客,我们可以及时总结归纳,通过写作来梳理思路,查漏补缺。

前言

为何而写
  • 技术成长:相对于庞大的计算机领域的知识体系,人的记忆还是太有限了,而且随着年龄的增大,记忆同样也会逐渐衰退,正如俗话所说“好记性不如烂笔头”。并且在分享博客的过程中,我们也可以和大神交流,进而发现自己的认知错误,纠正知识体系。最后最重要的就是通过记录博客,我们可以及时总结归纳,通过写作来梳理思路,查漏补缺。
  • 增大影响力:在当今世界,如果要谈论什么最有价值的东西,那无疑是影响力。网红和明星之所以能赚大钱,就是因为他们拥有巨大的影响力。在这个竞争激烈的时代,拥有强大的影响力的人,就是真正的胜利者。而写作无疑就是一个扩大影响力的工具。
  • 工作机会:在求职过程中,博客的作用也不容小觑,博客本身就是一个非常好的自我展示的平台,通过向面试官展示自己的技术广度和深度,可以让你比大多数求职者领先一步。
  • 额外收入:在自己博客/公众号租赁广告位,或是投放公司内推广告,抑或是写作平台签约写手,或是借助影响力写书卖书

image-20230719192253189

一、明确自身技术定位和受众

首先就是明确自身的技术定位,比如说我专研前端技术,那么博客的技术选题也要围绕此方向,从而营造个人IP,这里顺便说下选题

技术文章选题很多,这里大致分为以下几种:

  1. 新方法/新技术的布道:比如 JS 新特性,或者新的构建工具等等
  2. 技术方案总结类:比如弱网环境下的加载优化机制等等
  3. 优秀框架的体验指南:比如 react SSR 从 0-1 的过程等等
  4. 自己觉得很厉害的小技巧:比如一些独特的优化手段,JS 的黑魔法等等
  5. 原理剖析类:比如 XXX diff 原理等等
  6. 棘手问题的解决方案:比如CDN 被劫持的解决方案

其中前 3 点是比较适合新手同学入手的,可以根据自己的实际情况从这些点去做切入。可以从caniuse寻找新技术点

其次要明确写作目的,受众人群。也就是给博文定调,是轻松幽默、力求详尽,还是严肃认真、专业概括,亦或者其他风格。

自己看,就是随笔,个人笔记。可以随笔写,甚至可以是一句话,一张图。完全可以是自嗨文。

技术分享,这时就要考虑全面,不能写成自嗨文,要有一定的套路,要明确受众是哪些群体,是小白,还是高手,或者是领导。根据受众的喜好和自己的能力圈适当发挥。

约稿,一般情况甲方都会给一定的格式和要求,再结合技术分享的经验成稿。

自嗨文:网络流行词,就是调子很高,辞藻华丽,但没站在用户立场上写的文章。

二、选择合适写作平台

  • CSDN:国内最老牌的博客论坛,seo做得很好,用户量很大,但是文章质量一般不高,并且广告多,用户体验不好
  • 博客园:和CSDN同样属于老牌博客网站,具有良好seo,同时不乏优质博客,但是写作体验差,样式老旧(但是可以自定义美化)
  • 掘金:平台新,写作体验很棒,界面清爽,官方经常发布活动针对优秀写作者提供物质奖励
  • 腾讯云/阿里云社区:大牛专场,文章质量没得说,但不太很适合新手
  • 知乎/简书:两个平台均不是专门的技术网站,但是文章质量都比较不错,seo权重高,可以适合引流
  • 公众号:主要就是要把其他平台的流量进行引流,适合长期经营
  • 独立建站:相对来说比较麻烦,但是比较自由,需要针对seo优化,大牛博客:张鑫旭阮一峰廖雪峰

三、如何给文章起标题

平均而言,阅读标题的人是阅读正文的5倍- —— David Ogilvy

其实标题的重要性主要有两个,一是 SEO(搜索引擎)优化,二是提升读者阅读体验

标题关键点

1、简单

我阅读过关于文章标题的讨论基本都同意文章的标题要简单、简短和容易理解。如果违反这原则,你也能获得注意,这是那种困惑、不知所措的注意。短标题同样利于搜索引擎优化—标题要短于40个字符,这样可以确保标题全部出现在搜索结果中。

2、吸引注意力

好的标题能够让你的文章脱颖而出并吸引读者阅读。吸引注意力可以通过使用产生“震惊”、“呼吁”、“意外“甚至”困惑“效果的文字。这些文字可以吸引读者进入正文阅读,尽管可能是标题党的文不符题。尽可能用标题吸引读者,哪怕是利用一些小伎俩。

3、满足需求

好的标题可以让读者进入正文,就是因为读者认为有满足他们需求的内容。索引网站http://del.icio.us的一项调查表明,最吸引读者的标题通常都是“如何…”或者“…的教程”这类文章吸引读者,因为他们想解决遇到的相关问题。

4、直观

尽管许多读者也会被那些含糊的标题吸引进入正文,但是大多数读者都是喜欢直观的标题,便于决定是否进行更多的了解。标题应该简短直观表明正文的主要内容。

5、关键词

在本文前面我提到标题对于SEO的重要性,所以,如果你想充分利用这个作用,你需要思考如何选择更容易被关注的关键词。看起来标题又要简洁又要引人注目难以两全,但是还是可以做到的。比如,SEO中,标题前面的词组作用比后面的更有效果。

补充:如何撰写开头介绍/摘要

标题的作用是让读者开始阅读第一句。文章开头的任务是把读者吸引住并让他们继续读你的文章

开头介绍遵循APP公式,即匹配需求(Align),展示(Present),效果证明(Proof),示例

首先,我们匹配需求(Align)。用1至2句话,给你的用户展示你理解他们面临的问题。

接下来,展示(Present)你的文章作为解决方法。

告知他们你已经发现了该问题的解决办法。或在不泄露所有内容的前提下,也可尽量简短地解释这种方法。“喂食”人们一些内容,让他们可以继续看下去。

最后,给出我们的效果(Proof)证明。

这里你可以解释为什么他们要相信你。毕竟,你的访客很可能是第一次看你的博客或个人网站。你不得不证明你的成功,经验和专业。

image-20230719164805226

四、搭建文章框架结构

有时写着写着就写不下去了。如果提前搭好框架,做成思维导图,就会轻松很多,不至于写到一半卡壳。技术博客一般结构都是总-分-总。下面是一些我自己用的模板分享出来,做抛砖引玉用,各位如果有其他模板不妨分享出来,我们共同进步。

  • 提出问题->分析问题->解决问题->总结经验,技术问题分享。
  • 背景->思考->尝试->遇到的困难->解决方案->最后结果,问题分享
  • 摘要->简介->分支主题->总结,一般技术分享。
  • 是什么-原理-背景>解决了什么问题->基本操作->同类对比->总结 ,适合新技术分享

五、制作配图及相关素材

draw.io:在线的画图工具,非常强大,内置了各种常用的元素和图标。

image-20230719165339992

excalidraw:一款手绘形式的开源画图工具,无需登录,直接在网站上就能画图,可以很方便的导出文件,退出重进后,还会显示上次退出时画的图,非常方便,而且可以导入别人画的模块。但是不支持中文手写体,这里是支持中文手写体的网址

image-20230719165516798

六、如何写出更有吸引力的内容

易于阅读

没人喜欢阅读。他们只想要信息。如果他们能下载这些信息到大脑里面,他们就将会这么做。—— Tim Soulo

首先我们要做的就是如何是我们的文章易于阅读,推荐 Bond Halbert 的书 The Halbert Copywriting Method Part III,下面是简单总结

  • 使用短段落。Bond称这可以“缓解眼睛”。大量的文字会阻碍读者阅读,但短段落可以邀请他们来。类似Hemingway等工具可以使它变得更容易。
  • 分解长句。人们通常会跟着大脑里的声音阅读。因此,长句会使阅读很难跟上。通过在用“并且”、“因为”、“这”的地方找到实列来分解句子。
  • 插入多媒体。视频,图片,动图等可以在无需增加文字的情况帮你阐述观点。
  • 使用文字格式。 粗体,斜体,引用或者列表来分解大量的内容并可以强调特定的点。
  • 大声朗读你的文章。 这有助于你发现不太流畅或者无聊的内容。

表达形式

技术文章不一定就是一篇议论文或者是叙事文,可以探索更多的表达形式

  • 漫画类,比如程序员小灰,诙谐幽默,很有代入感
  • 微信 / 钉钉聊天框类,阅读体验也不错
  • 同人小说类,例如《JavaScript 百炼成仙》
  • 碎碎念文章,类似于张鑫旭大佬的文章风格,这种文章配合一些日常的段子啥的,也能起到非常不错的效果

换位思考

在写完一篇文章以后,并不代表你的文章就已经可以发布或者推广了,因为我们更多的是站在自己主观的角度来写的,所以为了保证文章的易读性,你还可以从以下几个方面去换位思考一下:

  • 如果我是个小白,这篇文章我能看懂吗?
  • 如果我不认识文章中的缩写词,我能理解这篇文章吗?
  • 我这里要不要加个架构图做说明呢?
  • 我这里要不要加个演示图做展示呢?
  • 我这里要不要加一下代码注释呢,万一对方是个初学者怎么办?
  • ...

同时还有一个技巧特别重要,就是把自己的文章多读几遍,早上睡醒的时候读一下,晚上睡觉前读一下,说不定读着读着,你的灵感又来了,同时还能发现不少错别字

参考文章:

技术博客写作指北——素材、排版和配图 (jiekun.dev)

[技术文章写作指南 - KubeSphere 开发者社区]

大神都在用的技术博客写作指南,首次公开,建议放枕边 - 掘金 (juejin.cn)

博客文章标题如何写? - 知乎 (zhihu.com)

如何写好技术文章——若川

推荐阅读

实战有效的17个博客运营技巧(新手必备) (ahrefs.com)

9 个技巧标题技巧,打造高点击率的博客页面 - 灵蹊社区 (getlingxi.com)

我是如何写好一篇技术博客的 - 掘金 (juejin.cn)

阮一峰: 中文技术文档的写作规范 (github.com) —— 强烈推荐!!!

寄语
  • 如果你永远在等好的主题,好的灵感,可能你这辈子都敲不出来一篇文章
  • 不要有功利心,少写 XXX 面试指南,多写真实的 case、感悟
  • 保持自己的风格,维持自己的人设
  • 思考当下,思考一切

本文部分图片来自 Wikipedia

目录
相关文章
|
28天前
|
机器学习/深度学习 人工智能 自然语言处理
AI技术深度解析:从基础到应用的全面介绍
人工智能(AI)技术的迅猛发展,正在深刻改变着我们的生活和工作方式。从自然语言处理(NLP)到机器学习,从神经网络到大型语言模型(LLM),AI技术的每一次进步都带来了前所未有的机遇和挑战。本文将从背景、历史、业务场景、Python代码示例、流程图以及如何上手等多个方面,对AI技术中的关键组件进行深度解析,为读者呈现一个全面而深入的AI技术世界。
113 10
|
11天前
|
自然语言处理 文字识别 数据处理
多模态文件信息抽取:技术解析与实践评测!
在大数据和人工智能时代,企业和开发者面临的挑战是如何高效处理多模态数据(文本、图像、音频、视频)以快速提取有价值信息。传统方法效率低下,难以满足现代需求。本文将深度评测阿里云的多模态文件信息抽取解决方案,涵盖部署、应用、功能与性能,揭示其在复杂数据处理中的潜力。通过自然语言处理(NLP)、计算机视觉(CV)、语音识别(ASR)等技术,该方案助力企业挖掘多模态数据的价值,提升数据利用效率。
35 4
多模态文件信息抽取:技术解析与实践评测!
|
5天前
|
Kubernetes Linux 虚拟化
入门级容器技术解析:Docker和K8s的区别与关系
本文介绍了容器技术的发展历程及其重要组成部分Docker和Kubernetes。从传统物理机到虚拟机,再到容器化,每一步都旨在更高效地利用服务器资源并简化应用部署。容器技术通过隔离环境、减少依赖冲突和提高可移植性,解决了传统部署方式中的诸多问题。Docker作为容器化平台,专注于创建和管理容器;而Kubernetes则是一个强大的容器编排系统,用于自动化部署、扩展和管理容器化应用。两者相辅相成,共同推动了现代云原生应用的快速发展。
46 10
|
14天前
|
域名解析 负载均衡 安全
DNS技术标准趋势和安全研究
本文探讨了互联网域名基础设施的结构性安全风险,由清华大学段教授团队多年研究总结。文章指出,DNS系统的安全性不仅受代码实现影响,更源于其设计、实现、运营及治理中的固有缺陷。主要风险包括协议设计缺陷(如明文传输)、生态演进隐患(如单点故障增加)和薄弱的信任关系(如威胁情报被操纵)。团队通过多项研究揭示了这些深层次问题,并呼吁构建更加可信的DNS基础设施,以保障全球互联网的安全稳定运行。
|
14天前
|
缓存 网络协议 安全
融合DNS技术产品和生态
本文介绍了阿里云在互联网基础资源领域的最新进展和解决方案,重点围绕共筑韧性寻址、赋能新质生产展开。随着应用规模的增长,基础服务的韧性变得尤为重要。阿里云作为互联网资源的践行者,致力于推动互联网基础资源技术研究和自主创新,打造更韧性的寻址基础服务。文章还详细介绍了浙江省IPv6创新实验室的成立背景与工作进展,以及阿里云在IPv6规模化部署、DNS产品能力升级等方面的成果。此外,阿里云通过端云融合场景下的企业级DNS服务,帮助企业构建稳定安全的DNS系统,确保企业在数字世界中的稳定运行。最后,文章强调了全链路极致高可用的企业DNS解决方案,为全球互联网基础资源的创新提供了中国标准和数字化解决方案。
|
14天前
|
缓存 边缘计算 网络协议
深入解析CDN技术:加速互联网内容分发的幕后英雄
内容分发网络(CDN)是现代互联网架构的重要组成部分,通过全球分布的服务器节点,加速网站、应用和多媒体内容的传递。它不仅提升了访问速度和用户体验,还减轻了源站服务器的负担。CDN的核心技术包括缓存机制、动态加速、流媒体加速和安全防护,广泛应用于静态资源、动态内容、视频直播及大文件下载等场景,具有低延迟、高带宽、稳定性强等优势,有效降低成本并保障安全。
59 4
|
1月前
|
机器学习/深度学习 人工智能 自然语言处理
秒级响应 + 99.9%准确率:法律行业文本比对技术解析
本工具基于先进AI技术,采用自然语言处理和语义匹配算法,支持PDF、Word等格式,实现法律文本的智能化比对。具备高精度语义匹配、多格式兼容、高性能架构及智能化标注与可视化等特点,有效解决文本复杂性和法规更新难题,提升法律行业工作效率。
|
1月前
|
数据采集 存储 JavaScript
网页爬虫技术全解析:从基础到实战
在信息爆炸的时代,网页爬虫作为数据采集的重要工具,已成为数据科学家、研究人员和开发者不可或缺的技术。本文全面解析网页爬虫的基础概念、工作原理、技术栈与工具,以及实战案例,探讨其合法性与道德问题,分享爬虫设计与实现的详细步骤,介绍优化与维护的方法,应对反爬虫机制、动态内容加载等挑战,旨在帮助读者深入理解并合理运用网页爬虫技术。
|
1月前
|
机器学习/深度学习 自然语言处理 监控
智能客服系统集成技术解析和价值点梳理
在 2024 年的智能客服系统领域,合力亿捷等服务商凭借其卓越的技术实力引领潮流,它们均积极应用最新的大模型技术,推动智能客服的进步。
92 7
|
1月前
|
负载均衡 网络协议 算法
Docker容器环境中服务发现与负载均衡的技术与方法,涵盖环境变量、DNS、集中式服务发现系统等方式
本文探讨了Docker容器环境中服务发现与负载均衡的技术与方法,涵盖环境变量、DNS、集中式服务发现系统等方式,以及软件负载均衡器、云服务负载均衡、容器编排工具等实现手段,强调两者结合的重要性及面临挑战的应对措施。
91 3

推荐镜像

更多