markdown静态博客搭建综述

一 说明

使用markdown写文档，搭建自己的个人博客。纯前端展示，不需数据库，不需后端编程交互。
选择市场上比较知名的静态博客搭建程序，对照比较，综合评价。

二 软件

2.1 docsify

docsify 可以快速帮你生成文档网站。不同于GitBook、Hexo的地方是它不会生成静态的 .html 文件，所有转换工作都是在运行时。

布署文档：git平台docsify布署markdown文件

2.2 mkdocs

在git平台创建mkdocs主题仓库，自动将markdown文件生成静态网页。

布署文档：gitlab、github、gitee布署mkdocs主题仓库

2.3 gitbook

GitBook可以看作个人的一本电子书。它用MarkDown编写，可以自动生成网页或者PDF等，生成网页可以通过插件配置目录和搜索功能等。

布署文档：gitbook部署博客

应用： https://scott180.github.io/gitbook-blog/
https://github.com/scott180/gitbook-blog

2.4 vuepress

Vue 驱动的静态网站生成器

官网： vuepress   vuepress-next
应用： github   vuepress-blog

布署文档：vuepress构建项目

2.5 vuepress-theme-reco

一款简洁而优雅的 vuepress 博客 & 文档 主题。

官网：vuepress-theme-reco   vuepress-reco
应用：github   reco-blog

布署文档：vuepress构建项目：vuepress-theme-reco

2.6 others

Github Pages

GitHub Pages 是 GitHub 提供的一项免费服务，它可以让用户轻松地创建自己的静态网站。

地址： https://github.com/scott180/calligraphy
应用： https://scott180.github.io/calligraphy
使用方法：Settings -- Pages -- Branch - Master -- Save

gitlab/gitee 也有类似的静态页面功能。 gitlab_pages   gitee_pages

netlify

Netlify 是一家位于旧金山的云计算公司，为用户提供Web 应用程序和动态网站构建、部署和无服务器后端服务。

地址： netlify   netlify-calligraphy-nextjs
应用： nextjs   artisan

Netlify Next.js Blog Template designed by Bejamas

Vercel

Vercel是一个专注于静态站点部署和服务器端渲染的云平台。

地址： vercel
应用： docusaurus2   portfolio

另外有 Hexo/Hugo/Jekyll 也可建站。

三 综述

操作感受
Hexo/Hugo/Jekyll 功能很强大，但是操作不太简单，上手难度有点高。
netlify / vercel 国外网站，不是太稳定。常常访问不了网站。
docsify/mkdocs/gitbook 这三个比较类似，布署简单，但是主题也单调简约，插件不是很多。
vuepress/vuepres-theme-reco 非常优秀的静态博客搭建方法，界面美观，功能齐全。就是安装布署的时候可能会有版本兼容问题。

另外在github/gitlab/gitee 的平台上搭建好静态博客，如要绑定域名，可查看文档：gitlab、github绑定自定义域名 。

我的网站
生活随笔-编程笔记-书法练习轨迹