"readthedocs+github开启你的免费markdown博客之旅"

Published on Aug. 22, 2023, 12:09 p.m.

虽然市面上有很多的免费博客或者说个人网站方案,不过不是广告,就是国内无法访问。

其实本人一直都比较喜欢blogger的,不过国内真的不好用啊。

最近几年好多程序员已经开始将github pages当作博客用了,github pages真的是很好的福利没错,不过有点我不习惯的是每次都要自己构建链接才行,不然的话就需要用jekyll主题定义后可以,自动生成,可是每次都要用固定的模板书写才行。

另外还有一个比较可行的方案,就是还是用github写markdown,不过要配合上readthedocs的mkdocs生成内容。这次就可以肆意妄为的书写了,只要放入docs目录下就完全不用管了,他可以自动搞定一切。

下面是一个例子

基于mkdocs构建文档博客demo

https://mkdocs-terry.readthedocs.io/en/latest/

复制这个代码就可以

https://github.com/napoler/mkdocs_terry

还有个福利,就是可以绑定域名啊。

如果没有域名可以去http://www.dot.tk/zh/index.html申请个免费的域名。

只要简单设置就可以拥有自己的独立博客了。

https://readthedocs.org/是一个用来共享文档的网站,用来做博客虽然有点不务正业,不过要是分享知识的话,也是一样的。

好多人建议用Sphinx,这个真的不如mkdocs来的简单易用,反正博客。

感觉这应该是用markdown写文档最简单的方案了。

一次设置之后,完全可以告别代码了。以后只用专心写文档就ok了。