2023-09-01 15:35:06

# markdown静态博客搭建综述

# 一 说明

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


# 二 软件

# 2.1 docsify

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

布署文档:git平台docsify布署markdown文件 (opens new window)

名称 仓库 备注
plain-docsify gitlab plain-docsify (opens new window) 网页 (opens new window)
github plain-docsify (opens new window) 网页 (opens new window)
笔记docsify
myblog-docsify gitlab myblog-docsify (opens new window) 网页 (opens new window)
github docsify-blog (opens new window) 网页 (opens new window)
笔记与博客docsify

# 2.2 mkdocs

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

布署文档:gitlab、github、gitee布署mkdocs主题仓库 (opens new window)

仓库 地址 备注
gitlab plain-mkdocs (opens new window) 网页 (opens new window)
plain-pip-mkdocs (opens new window) 网页 (opens new window)
plain-mkdocs-gitbook (opens new window) 网页 (opens new window)
gitlab布署mkdocs:配置文件.gitlab-ci.yml。
github plain-mkdocs (opens new window) 网页 (opens new window)
plain-pip-mkdocs (opens new window) 网页 (opens new window)
plain-mkdocs-serve (opens new window) 网页 (opens new window)
github布署mkdocs:命令mkdocs gh-deploy 。
gitee plain-mkdocs (opens new window) 网页1 (opens new window) 网页2 (opens new window) 网页3 (opens new window) gitee布署mkdocs:mkdocs build 布署目录。
note-mkdocs gitlab note-mkdocs (opens new window) 网页1 (opens new window) 网页2 (opens new window)
github note-mkdocs (opens new window) 网页 (opens new window)
gitee plain-mkdocs (opens new window) 网页 (opens new window)
个人笔记,含书法练习及java笔记。
myblog-mkdocs gitlab mkdocs-blog (opens new window) 网页 (opens new window)
gitee myblog-mkdocs (opens new window)

# 2.3 gitbook

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

布署文档:gitbook部署博客 (opens new window)

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

# 2.4 vuepress

Vue 驱动的静态网站生成器

官网: vuepress (opens new window) vuepress-next (opens new window)
应用: github (opens new window) vuepress-blog (opens new window)

布署文档:vuepress构建项目 (opens new window)

# 2.5 vuepress-theme-reco

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

官网:vuepress-theme-reco (opens new window) vuepress-reco (opens new window)
应用:github (opens new window) reco-blog (opens new window)

布署文档:vuepress构建项目:vuepress-theme-reco (opens new window)

# 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 (opens new window) gitee_pages (opens new window)


netlify

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

地址: netlify (opens new window) netlify-calligraphy-nextjs (opens new window)
应用: nextjs (opens new window) artisan (opens new window)

Netlify Next.js Blog Template designed by Bejamas


Vercel

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

地址: vercel (opens new window)
应用: docusaurus2 (opens new window) portfolio (opens new window)


另外有 Hexo (opens new window)/Hugo (opens new window)/Jekyll (opens new window) 也可建站。


# 三 综述

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

另外在github/gitlab/gitee 的平台上搭建好静态博客,如要绑定域名,可查看文档:gitlab、github绑定自定义域名 (opens new window)


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

徐书法 地址 备注
1 xushufa (opens new window) vuepress-theme-reco构建的博客网站。
2 vuepress-blog (opens new window) vuepress构建的博客网站。
3 mkdocs-blog (opens new window) mkdocs构建的博客网站。