技术博客的开头,中间,结尾都该怎么写?

Posted 梦想橡皮擦

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了技术博客的开头,中间,结尾都该怎么写?相关的知识,希望对你有一定的参考价值。

橡皮擦,一个逗趣的互联网高级网虫,为你带来新职场故事,搬来程序员敲门砖。

已完成文章

本文内容:博客内容与行文框架
技术博客的开头,中间,结尾都该怎么写?

技术博客的内容与行文框架

内容怎么写

一篇好的技术博客,一定是人为加工出来的,这里就涉及到了文章框架,文章开头与结尾都如何设计,如何去写。

在文章开始,先给大家提供一些,与内容写作有关的小提示。

  1. 技术博客写作,优先使用 Markdown 格式写作,富文本写作的时代已经过去;
  2. 要学会分段,多分段;
  3. 掌握总分总写作结构;
  4. 每篇博客的字数,控制在 1500~2000 字以内(特殊情况除外);
  5. 写作前,提前准备大纲,例如本系列课程开篇的脑图。

更多的写作细节内容,可以阅读一个神奇的开源项目:中文技术文档的写作规范,必有所得。

开头怎么写

上篇博客,橡皮擦带你简单学习了一下标题的套路,本篇上来带给你如何写好 “套路” 型的开头。

博客的开头,只有一个目的,就是让打开本文的读者,阅读下去,所以开头你可以这样写:

陈述一件事情+提出问题

例如:

今天我碰到了一个缓存 BUG,我是这样解决的。

下班我还没有走,还在处理一个文件读取 BUG,好想知道技术组长是怎么解决的?

mysql 读取 1W 数据,需要 10 秒,如何才能优化到 1 秒呢?

设置悬念+引发好奇

例如:

要不是处理了这个乐观锁,我可能就离职了!

技术总监在全员大会上,“狠狠” 的夸了我,就因为我完成了一个陈年大 BUG。

直接告诉读者收获

例如:

学完本文你能掌握如下技术。

本文将通过 Python 爬取腾讯动漫数据。

反常理描述

该类型与 设置悬念+引发好奇 殊途同归,为激发读者兴趣。

例如:

为何我把数据库读取速度减慢?

为什么上线前,我把秒杀按钮缩小了?

对话开头

该种形式的文章开头,是上述内容的一个综合应用,目的在于让读者,能感受到一个真实存在的场景。呈现方式可以直接文字展示,也可以微信/QQ 窗口截图。

例如:

小李:总监,我这个并发一直处理不好?
总监:……

一个好的开头,可以让读者顺利从标题,过度到你的文章内容上来,并且可以引导读者继续阅读。
一个好的开头,是文章标题的延伸,甚至是一个点睛的副标题。

结尾怎么写

结尾核心的目的总结全文,如果能激发读者思考,或让读者阅读更多的文章,或者能让读者产生文字交流的欲望,那结尾就发挥了最大价值。

一般结尾按照如下方向写作即可。

  1. 总结文章知识点,并进行扩展;
  2. 提供更多的阅读资料,增加其它文章的曝光率/阅读率;
  3. 提出新问题或其它方案,让大家探讨;
  4. 附录一个源码下载地址,共大家学习;
  5. 也可号召让大家收藏,点赞你的文章。

一定要注意,文章不要突然刹车,即使结尾只有短短的一句话,也要优于

内容怎么写

开头与结尾在一篇博客中,占的篇幅很小,重要的还是主体内容部分。毕竟好内容,才能决定一篇文章的好坏。

在内容部分,橡皮擦给你的建议如下:

  1. 尽量分段;
  2. 减少大段代码,代码越多,阅读体验越差;
  3. 给仅有的代码增加注释,清晰的注释;
  4. 适当增加图示说明;
  5. 使用列表,表格。

好的内容也依托于行文风格,你可以从临摹别人的风格开始。

  1. 漫画型,需要一定的美术基础;
  2. 故事型,让文章从一篇故事开始,以故事 Happy Ending 结尾;
  3. 对话型,通过 A 与 B 的对话,阐述技术点;
  4. 逗趣型,内容,语言搞怪,可通过表情包表述心情;
  5. 纯技术流/学术派,扎实的理论基础;

行文风格,可以不断尝试,最终得到最适合自己的风格,也可以多种进行组合,或者开拓新的写作方式。

有两点需要注意:

全文都是图片,不易被搜索引擎收录。

全篇都是代码,会给读者造成极大的阅读障碍。

写在后面

开头,内容,结尾,总分总,技术博客写作基础框架,希望本文能对即将开始写作的你,有所帮助。

本文完。

2021 年 7 月 4 日 梦想橡皮擦,发布于河北石家庄。
下一篇主题:
技术博客素材收集


今天是持续写作的第 175 / 200 天。可以点赞、评论、收藏啦。

以上是关于技术博客的开头,中间,结尾都该怎么写?的主要内容,如果未能解决你的问题,请参考以下文章

英语图表作文应该怎么写

正则匹配开头为''结尾为','应该怎么写?

正则表达式每行开头怎么表示

你也要写技术博客?这篇博客告诉你平台怎么选

技术博客的标题怎么写,竟然真的有套路

第一篇博客