我从大学开始写博客,如何写一篇技术博客,谈谈我的看法!
前言
只有光头才能变强。
文本已收录至我的GitHub精选文章,欢迎Star:https://github.com/ZhongFuCheng3y/3y
我一直推崇学技术可以写技术博客去沉淀自己的知识,因为知识点实在是太多太多了,通过自己的博客可以帮助自己快速回顾自己学过的东西。
我最开始的时候也是只记笔记,认为自己能看得懂就好。但如果想验证自己是不是懂了,可以写成技术博客。在写技术博客的过程中肯定会发现:“这个知识点,我好像还有些没搞懂”。
从梳理/编写的过程,自己也会成长不少
有不少的小伙伴曾经问过我:
- “3y你是怎么记笔记的阿?我一边看视频一边记笔记,顾头不顾腚的”
- “你写的博客都是怎么思考的阿?我不会写博客”
下面来谈谈我一些观点(个人/主观),每个人都有自己的方法论,我的观点不适用于所有人。
开局一张图,内容全靠编:
一、如何写一篇技术博客
首先,我认为要把自己当做是一个分享者,而读者是一个小白。然后模拟这个场景:如果你要把你学习到的技术分享给小白,你需要怎么去做。
按照我的思路,我可能会这样做:
- 首先,这项技术是什么你得先告诉他。
- 接着,为什么要学习这项技术,学习了这项技术有什么好处。有没有以前的技术跟这个较为相似的,为什么我不用以前的,而要学新的。(这一步非常非常重要)
- 然后,这项技术的核心用法是什么,给出一些小案例,让小白体验到这项技术。
- 最后,用这项技术可能会出现什么问题,官方有没有提供方案解决,如果没有,可能的解决方案有哪些。
大白话来说,其实就是:
- 是什么
- 为什么
- 怎么做
一般来说,我会把重点放在 为什么 ,因为我一直认为学习一门技术一定得知道:为什么要学。
举个例子,我当初写【消息队列】的思路:
- 回顾一下什么是队列,Java已经支持各种类型的队列了,跟消息队列有什么不同。
- 为什么要用消息队列,不用行不行?用消息队列的好处有哪些
- 用了消息队列可能会带来的问题
如果遇到逻辑可能较为复杂,或者认为读者会看不太懂的时候,可以画图来描述一下,这样整一篇文章看下来就不会太枯燥。
其实吧,我写文章都是按自己学习时的思路来写。如果我在学习时中途某个地方卡住了,我就认为可能读者在学习的时候也会存在同样的问题。所以,我就把我的理解给记录下来,如果有必要就画图来讲解。
我写了两百多篇Java技术博客,有需要的同学可以关注我的GitHub,欢迎一起学习和交流:https://github.com/ZhongFuCheng3y/3y
二、文章需要有自己的风格
每个人写出来的博客都有自己的风格。
比如说有漫画型的:
比如说有故事型的:
比如说有骚气型的:
比如说有纯干货型的:
说了这么多,其实我想说的是:写博客应该要带有属于自己的风格。而不是把网上的资料直接复制粘贴就完事了,这样没有感情,没有灵魂。(当然了,如果网上可能的确有写得很好的,可以这么做,但不可能整一篇都是相同的嘛)
三、关于排版
一篇好的技术文章,它的排版一般不会差。我认为写技术文章有几点可以提高一下阅读体验:
- 整篇文章不要90%都是代码,适当减少代码,贴关键的部分就好了。(完整的代码可以上传到GitHub)
- 多分段,技术文章可能就相对枯燥,如果将技术的说明挤在一块,可能阅读起来没那么好的体验
- 增加图示说明 or 插入相关的图片
程序员写文章一般都用Markdown
语法了,使用恰当的话,文章的排版自然也不会太差啦。所以还没用Markdown
语法的同学可以赶紧用起来,这玩意特好学,从学到用起来就几分钟。
- 我当时连简历都是
Markdown
语法…
四、关于工具
Markdown编辑器我推荐使用Typora
,无论是在Mac还是在Windows上都很好用。使用Markdown就肯定要考虑一个问题:图床用哪家?
无论使用哪家图都有可能会挂,自己搞个图床可能会安全一些(相对来说会比较麻烦),我自己是使用掘金
的图床的。而我的文章往往会分发到几个博客网站上,像简书/知乎
这种会单独将图片上传到他们的服务器上。
所以,从我个人的使用角度而言,并不会担心图床会挂问题。如果你将文章只发送到一个平台中,还是得关注一下图床是否可能失效的问题。
至于你发哪个平台,我曾经写过一篇【程序员可以选择哪些平台写技术博客?】,当时的总结:
- 如果不嫌弃
博客园
的风格,可以选择博客园
。否则建议选择:掘金
/SegmentFault
。 - 只想管理自己写过的文章,选择:
GitHub/GitBook
- 喜欢折腾:
Hexo+GitHub
或者WordPress
简单的流程图/思维导图/..
可以使用ProcessOn
就解决掉了。
最后
有的没的扯了一些,希望能够对「有想要写技术博客,但无从下手的同学」一些帮助。
涵盖Java后端所有知识点的开源项目(已有5.8K star):https://github.com/ZhongFuCheng3y/3y
如果大家想要实时关注我更新的文章以及分享的干货的话,可以关注我的公众号「Java3y」。(微信搜Java3y即可关注)
-
我从大学开始写博客,如何写一篇技术博客,谈谈我的看法!相关推荐
- 写好一篇技术博客的正确姿势是什么
写好一篇技术博客的正确姿势是什么 今天写博客的时候,发现不知道怎么构思,怎么布局了.然后就想到了以下这些问题: 怎么写出来对别人更有价值的文章,同时也更方便自己下次阅读,方便读者阅读? 为什么别人写的 ...
- 11. 一篇技术博客,如何获得更多的收藏呢?本篇博客告诉你
欢迎来到橡皮擦的写作课 本文内容:面向收藏夹的写作 本篇文章从收藏二字出发,为你揭示何种文章,最易引起读者加入收藏夹. 面向收藏夹的写作 一篇文章的好坏,最直接的反馈就是读者将其纳入收藏,尤其在以推荐 ...
- 国内第一创作平台大佬,教你如何写好一篇技术博客?
码个蛋(codeegg) 第 975 次推文 作者:九心 链接:https://juejin.im/post/5ec29c16e51d454d9b12677f 前言 很多同学的进阶都是从写文章开始的, ...
- 计算机技术博客博客知乎,我的技术博客的选择:CSDN、博客园、简书、知乎专栏仍是Github Page?...
有不少技术人员在学习到必定程度后发现了写博客的重要性,一方面帮助本身记忆,一方面也能帮助他人解决问题,因而会选择本身开始写博客,以后又发现平台太多不知从何下手,在这里我根据本身写博客的经验比较一下各个 ...
- 小熊的第一篇技术博客——机器学习绪论
机器学习(一) 大三的时候学习了<机器学习>这门课程,作为一个热爱数学的工科女,这门课程让我知道了如何应用数学到人工智能这个领域以及数学确实能够给人类带来一些隐形的好处(可能有时候在推导不 ...
- 写篇技术博客被简书锁定是一种什么样的体验
... 图片发自简书App 图片发自简书App
- html编写个人博客_第 06 篇:博客从“裸奔”到“有皮肤”
作者:HelloGitHub-追梦人物 文中涉及的示例代码,已同步更新到 HelloGitHub-Team 仓库 点击本文最下方的"阅读原文"即可获取 在此之前我们已经编写了博客的 ...
- CSDN、博客园等6大技术博客平台的写作体验测评
功能对比 csdn 博客园 知乎 简书 segmentfault 开源中国 markdown编辑器 √ √ x √ √ √ 富文本编辑器 √ √ √ √ x √ 默认编辑器 富文本 富文本 富文本 富 ...
- CSDN、博客园等6大技术博客平台的写作体验测评 1
2019独角兽企业重金招聘Python工程师标准>>> 功能对比 csdn 博客园 知乎 简书 segmentfault 开源中国 markdown编辑器 √ √ x √ √ √ 富 ...
最新文章
- VC++ 6.0的小花招
- VTK:PolyData之MeshQuality
- 2018年9月杭州云栖大会Workshop - 基于日志的安全分析实战
- php渲染nodejs api,nodejs通过响应回写渲染页面步骤详解
- 电脑内存16g和32g,有什么区别?
- 基于python的证件照_用20行python代码给证件照换底色
- [Java] 蓝桥杯ALGO-111 算法训练 明明的随机数
- 中兴java笔试题_中兴Java开发笔试题目及答案(7)
- 如果unity双击无法打开怎么办
- python用opencv实现图片的美白磨皮_OpenCV 磨皮-Python
- Excel表格中如何换行
- LaTeX插入视频示例
- BMP格式详解<转>
- 从虎胆龙威4(live free or die hard)说黑客攻击
- 电脑装服务器硬件,服务器硬件系统的维护拆装篇 -电脑资料
- 可靠性测试主要注意点
- 将DataFrame中的时间转换为时间戳
- postgresql 数据库 alter table alter column set default 的一些实践
- is not accessible from java.lang.Class XXX
- 清理C盘空间,让你的C盘多出几个G的空闲空间来
热门文章
- 写好一篇技术博客的正确姿势是什么