发现一个项目与 MkDocs 类似的项目 PyMdown 拓展文档 ，等待探索。

---

1.排版模仿

以下网站使用 MkDocs 构建

• Material for MkDocs 的美化 - Charles Le's Notebook (charleschile.com)

• Documentation - Home Assistant (home-assistant.io)

• Godot Docs – master branch — Godot Engine (latest) documentation in English

• 未央学习 (weyoung-learn.github.io)

• Python Packaging User Guide

• Material for MkDocs - Material for MkDocs 中文文档 (llango.com)

• Packaging Python Projects - Python Packaging User Guide

• Introduction - OpenFaaS

• Debezium Documentation

2.MarkDown 语法

​​

学习 Markdown 语法

MarkDown 编辑器也很丰富：思源笔记、typore、obsidian、vs code 等。

3.项目结构

三部分组成

├── docs/
├── mkdocs.yml
└── site/

• mkdocs.yml：是一个非常易用的配置文件。
• docs：文档库，用户编写的 md 文档存放到此处。
• site/ ：静态网站资源，用户使用命令一键生成网站，保存到此处。

一键生成网页：文档库 md ---> 网站的 html

​​

网站页面的层级关系 = docs 文件夹下 md 文档的层级关系。

4.发布静态网站

静态网站对服务器性能要求非常低：512M 内存 +1 个核心即可流畅运行网站。

这几天正好可以领取 serv00 的免费“虚拟主机”，领完后还会给你一个二级域名。

​​

​MkDocs build ​用这几篇笔记生成 site 文件，把 site 文件夹打包上传到虚拟主机，解压缩到二级域名的目录，重命名为 public_html ​文件夹。变成静态网站。

​​

通过 serv00 送的二级域名访问网站

​​

总结 MkDocs 的使用体验：

不适合思源笔记用户：

• 首先我是思源笔记用户，思源笔记不是以 Markdown 格式存储笔记的，修改笔记之后要先导出为 Markdown，放到 MkDocs 项目的 docs 目录下，才能够预览网站的效果。
• 经常改 Markdown 文档，因为我想看看不同的样式哪个合适，然后就特别累。
• 不过思源笔记有一宽插件（基于 MkDocs）可以一键生成静态网站，代价是网页比较朴素。

​​

后面会直接使用一键生成插件，不折腾了，比较惋惜原生 MkDocs 那么多好看的格式，在插件中用不了。希望作者持续开发，早日完善，加油啊！

给插件作者点个 start 吧，谢谢啦！byname1234/siyuan-plugin-note-to-website (github.com)

‍