技术博客的开头,中间,结尾都该怎么写?
Posted 梦想橡皮擦
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了技术博客的开头,中间,结尾都该怎么写?相关的知识,希望对你有一定的参考价值。
橡皮擦,一个逗趣的互联网高级网虫,为你带来新职场故事,搬来程序员敲门砖。
已完成文章
- 国内,首套,成体系,技术博客写作专栏发布啦
- 技术博客只能写技术文章吗?当然是由我们自己来定义。
- 为“她”而写的技术博客,是怎样的?
- 你也要写技术博客?这篇博客告诉你平台怎么选
- 写第一篇博客,最好的时间是今日,今时,今刻
- 如果你也要写博客了,看看本篇博客中提及的选题吧
- 技术博客的标题怎么写,竟然真的有套路
本文内容:博客内容与行文框架
技术博客的内容与行文框架
内容怎么写
一篇好的技术博客,一定是人为加工出来的,这里就涉及到了文章框架,文章开头与结尾都如何设计,如何去写。
在文章开始,先给大家提供一些,与内容写作有关的小提示。
- 技术博客写作,优先使用 Markdown 格式写作,富文本写作的时代已经过去;
- 要学会分段,多分段;
- 掌握总分总写作结构;
- 每篇博客的字数,控制在 1500~2000 字以内(特殊情况除外);
- 写作前,提前准备大纲,例如本系列课程开篇的脑图。
更多的写作细节内容,可以阅读一个神奇的开源项目:中文技术文档的写作规范,必有所得。
开头怎么写
上篇博客,橡皮擦带你简单学习了一下标题的套路,本篇上来带给你如何写好 “套路” 型的开头。
博客的开头,只有一个目的,就是让打开本文的读者,阅读下去,所以开头你可以这样写:
陈述一件事情+提出问题
例如:
今天我碰到了一个缓存 BUG,我是这样解决的。
下班我还没有走,还在处理一个文件读取 BUG,好想知道技术组长是怎么解决的?
mysql 读取 1W 数据,需要 10 秒,如何才能优化到 1 秒呢?
设置悬念+引发好奇
例如:
要不是处理了这个乐观锁,我可能就离职了!
技术总监在全员大会上,“狠狠” 的夸了我,就因为我完成了一个陈年大 BUG。
直接告诉读者收获
例如:
学完本文你能掌握如下技术。
本文将通过 Python 爬取腾讯动漫数据。
反常理描述
该类型与 设置悬念+引发好奇 殊途同归,为激发读者兴趣。
例如:
为何我把数据库读取速度减慢?
为什么上线前,我把秒杀按钮缩小了?
对话开头
该种形式的文章开头,是上述内容的一个综合应用,目的在于让读者,能感受到一个真实存在的场景。呈现方式可以直接文字展示,也可以微信/QQ 窗口截图。
例如:
小李:总监,我这个并发一直处理不好?
总监:……
一个好的开头,可以让读者顺利从标题,过度到你的文章内容上来,并且可以引导读者继续阅读。
一个好的开头,是文章标题的延伸,甚至是一个点睛的副标题。
结尾怎么写
结尾核心的目的总结全文,如果能激发读者思考,或让读者阅读更多的文章,或者能让读者产生文字交流的欲望,那结尾就发挥了最大价值。
一般结尾按照如下方向写作即可。
- 总结文章知识点,并进行扩展;
- 提供更多的阅读资料,增加其它文章的曝光率/阅读率;
- 提出新问题或其它方案,让大家探讨;
- 附录一个源码下载地址,共大家学习;
- 也可号召让大家收藏,点赞你的文章。
一定要注意,文章不要突然刹车,即使结尾只有短短的一句话,也要优于 无。
内容怎么写
开头与结尾在一篇博客中,占的篇幅很小,重要的还是主体内容部分。毕竟好内容,才能决定一篇文章的好坏。
在内容部分,橡皮擦给你的建议如下:
- 尽量分段;
- 减少大段代码,代码越多,阅读体验越差;
- 给仅有的代码增加注释,清晰的注释;
- 适当增加图示说明;
- 使用列表,表格。
好的内容也依托于行文风格,你可以从临摹别人的风格开始。
- 漫画型,需要一定的美术基础;
- 故事型,让文章从一篇故事开始,以故事 Happy Ending 结尾;
- 对话型,通过 A 与 B 的对话,阐述技术点;
- 逗趣型,内容,语言搞怪,可通过表情包表述心情;
- 纯技术流/学术派,扎实的理论基础;
行文风格,可以不断尝试,最终得到最适合自己的风格,也可以多种进行组合,或者开拓新的写作方式。
有两点需要注意:
全文都是图片,不易被搜索引擎收录。
全篇都是代码,会给读者造成极大的阅读障碍。
写在后面
开头,内容,结尾,总分总,技术博客写作基础框架,希望本文能对即将开始写作的你,有所帮助。
本文完。
2021 年 7 月 4 日 梦想橡皮擦,发布于河北石家庄。
下一篇主题:
技术博客素材收集
今天是持续写作的第 175 / 200 天。可以点赞、评论、收藏啦。
以上是关于技术博客的开头,中间,结尾都该怎么写?的主要内容,如果未能解决你的问题,请参考以下文章