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

已完成文章

• 国内，首套，成体系，技术博客写作专栏发布啦
• 技术博客只能写技术文章吗？当然是由我们自己来定义。
• 为“她”而写的技术博客，是怎样的？
• 你也要写技术博客？这篇博客告诉你平台怎么选
• 写第一篇博客，最好的时间是今日，今时，今刻
• 如果你也要写博客了，看看本篇博客中提及的选题吧
• 技术博客的标题怎么写，竟然真的有套路

本文内容：博客内容与行文框架

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

内容怎么写

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

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

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 天。可以点赞、评论、收藏啦。

cs