写技术博客的一些心得分享

时间:2022-09-26 15:18:27

作者: Grey

原文地址:

博客园:写技术博客的一些心得分享

CSDN:写技术博客的一些心得分享

写博客有很多好处,见[BetterExplained]为什么你应该(从现在开始就)写博客

最初写博客用的是 Word,平台是博客园,Word 可以通过这种方式将文章一键发布到博客园。

后来学会了 markdown,写 markdown 的工具有很多,比如:typoraStackEditVisual Studio Code等,对我来说,都差不多,但是Visual Studio Code有一款插件可以自动格式化 markdown 的插件----markdownlint,非常好用,Visual Studio Code就成为我主力写博客的工具了,同时,也把 CSDN 作为自己的一个主力博客平台,和博客园同步更新。不过,这里还是想吐槽一个 CSDN 的博客编辑器的问题 ????

原先是 Word 文档,其实迁移不太方便,因为很多平台不支持 Word 的直接导入和复制粘贴,用了 markdown ,博客迁移的成本就低了很多,比如有段时间心血来潮,我在自己的服务器上折腾搭建了一个博客,要把原先博客平台的博客迁移过去,因为是 markdown 格式,自建博客可以直接渲染显示出来。

PS:自建博客的评论和留言都比较麻烦,需要绑定第三方的账户,所以用过一段时间就放弃了。????

选择图床

使用 markdown 写博客主要的问题是要选择一个稳定的图床。

我采用的是把图片复制到 CSDN 或者博客园,这样会生成一个图片链接,直接采用这个链接作为图片链接即可,这样生成的图片链接也比较稳定。

操作方式如下

CSDN生成图片链接方式

写技术博客的一些心得分享

博客园生成图片链接方式

写技术博客的一些心得分享

备份博客

原先备份的方式是直接存在 OneDrive 中,目录按照博客分类建好。无论在公司和家里,OneDrive 都可以很方便的同步所有内容。

写技术博客的一些心得分享

但是 OneDrive 不方便看博客的版本历史,所以后续把博客都备份到了 GithubGitCode 中。因为很多未整理的博客,所以仓库设置成了私有仓库。之所以把博客放到了两个远端仓库,也是备份的需要。使用 Git 也可以很方便把文件推送到多个远端仓库,参考:Git 推送到多个远程仓库

博客模板

我的博客模板很简单,如下内容

# 博客标题

作者: [Grey](https://www.cnblogs.com/greyzeng/)

原文地址:

[博客园:博客标题](#)

[CSDN:博客标题](#)

## 说明


## 参考资料

素材收集

素材来源包括如下几个方面:

  1. 实体书

  2. 电子书/博客/专栏

  3. 视频教程

  4. 微信,社区

主力收集工具是 OneNote,收集方式有如下三种

配置

Visual Studio Code 我只装了如下几个插件

写技术博客的一些心得分享

其中 markdownlint 插件是我选择 Visual Studio Code 作为 md 编辑器的原因,

安装这个插件后,只需要配置一个选项

"editor.codeActionsOnSave": {
    "source.fixAll.markdownlint": true
}

这个配置可以在你保存 markdown 文件的时候,自动格式化 markdown 文档,使用起来很方便,但是前提是要熟练使用 markdown 语法。

关于 markdown 的学习,我觉得最好的方式还是多用 markdown 写博客,当你用 markdown 写博客超过 10 篇,很多 markdown 语法自然就熟悉了,也可以通过类似的方法学习 Vi,Shell,Git。

CSDN 也提供了Markdown 技能树

我有段时间,学习了很多内容,但是博客却迟迟不肯动手写,总要等到自己完全掌握了一些东西才敢写出来,不过后来当我不断梳理总结自己的博客的时候,发现,写博客已经成为自己的一个习惯了。

邹老师在02 每一行代码,都是你最好的名片 |《编程人生》中说到:莽撞地开始,拙劣地完成,也好过心怀完美主义而迟迟不肯动手去做。解决问题的最好步骤是:

首先让程序跑起来(make it work)

其次让程序运行正确(make it work right)

再次让程序跑的快并且可维护(make it work fast & maintainable)

所以,写博客是不是也可以有一个最好的步骤:

首先把博客写出来

其次把博客中的存在的问题修正过来

再次让博客可以持续更新并维护

最后,分享最近看到的一段话和大家共勉

『真正的目标不是实现完美,而是自我完善,在这个旅途中不断发展,拥抱缺陷,并获得成长与学习的能力。因此,我们要追求连贯性,而不是完美性。』