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