一键将markdown笔记文档转成专业网站

[jaywhj]

平时的markdown文档、笔记，规整后可以使用开源软件一键生成一个专业的站点，方便形成个人品牌，方便输出、方便自己进步和交流。

类似的工具很多，这里推荐 mkdocs-materialx GitHub - jaywhj/mkdocs-materialx: MaterialX, the next generation of mkdocs-material
一款 极简易用、轻量级的静态网站生成器，基于 MkDocs，相比 Hugo、Hexo、Jekyll 之类的工具，这个更简易、更轻量，也很流程，适合普通大众。

这是下一代 mkdocs-material，由个人开发者持续维护的版本，步骤可以查看文档 https://jaywhj.github.io/mkdocs-materialx/

[Qingwa (青小蛙)]

不来几张对比图么

[jaywhj]

是的，是的，必须有，我来几个对比图！

[jaywhj]

对比图已经更新，请查看！

[jaywhj]

效果图

快速开始

一共 2 步，下载安装，运行启动，特简单：

1. 下载模板：下载最新模板文件 jaywhj.github.io-main.zip ，然后解压
2. 安装依赖：切换到解压目录后，执行 pip install -r requirements.txt
3. 编译启动：执行 mkdocs serve -o 或 mkdocs build
4. 预览效果：打开浏览器访问 http://127.0.0.1:8000，或直接双击 site/index.html 打开

详细原理和教程可参考：使用 MkDocs 生成静态网站 - 文档即产品

[kat]

真是好东西！前几天我折腾 Hugo 搭建网站的。命令行操作，再加上联网，特别容易出错，我已经患上了命令行报错恐惧症，正需要这种工具。可惜网站已经搭好了，不然高低得优先试试楼主这个。

[HaujetZhao (淳帅二代)]

是个好东西！

[jaywhj]

是的，现在的方案特简单，你可以试试，2分钟就搞定了

[jaywhj]

是的，还是很方便的，1-2分钟就搞定了

[kasusa]

咋用的呀 我根本没看懂

[jaywhj]

上面快速开始里面写的有，一共就2步，非常简单：

一键将markdown笔记文档转成专业网站

效果图 [11] [22] [33] [44] [55] 快速开始 一共 2 步，下载安装，运行启动，特简单： 下载模板：下载最新模板文件 jaywhj.github.io-main.zip ，然后解压 安装依赖：切换到解压目录后，执行 pip install -r requirements.txt 编译启动：执行 mkdocs serve -o 或 mkdocs build 预览效果：打开浏览器访问 http://127.0.0.1:8000，或直接双击 site/index.html 打开 详细原理和教程可参考：使用 MkDocs 生成静态网站 - 文档即产品

[Wcowin]

极简风格挺好

[jaywhj]

是的，极简风够了