作为资深 md 工程师，安利一个高颜值的文档神器

[arobota]

material mkdocs

又好看，又好用，我都用这个部署博客了

https://www.leosirius.fun/

另外打个广告：leetcode 题解，几乎每题都有解题思路和单元测试，不断补充中 https://github.com/LeoSirius/leetcode_solutions

[yazoox]

md 工程师？专业写文档？

[whileFalse]

哥们你这个主页……真是……丑哭了……
还有就是那个工具，找了 10min 没找到 mkdocs.yaml 的入门写法，于是我流失了。

一个优秀的新手向导是什么样的？在有一堆 md 文件的目录下执行一条命令即可启动（使用 docker ）；
entrypoint.sh 发现没有配置文件，于是自动创建一个最简单的默认配置文件，并自动扫描目录下的 md 文件添加到当前配置文件中；自动创建默认主页教用户最简单的配置文件应该怎么写。

[arobota]

@whileFalse 官方文档就有，github repo 里也有
https://github.com/squidfunk/mkdocs-material/blob/master/mkdocs.yml

[arobota]

@whileFalse 另外那个站只是记录文档，这个才是主页
https://www.leosirius.com/

[whileFalse]

@arobota #3 我看到这个文件了，然而 repo 根目录下这个 yml 应该是以展示所有功能为目的编写的，过于复杂，无法在短时间内理解并套用。

[LuckyDee]

话说老哥你刷了多久刷完的

[fakepoet]

@arobota 主页也不好看啊。。。

[arobota]

@LuckyDee 并没刷完。。。

[lscexpress]

他们都说你主页丑，审美不一样，别在意。

但你的网站是真的慢，即使 304 的情况下，依旧达到了 800ms 。

[tubimasky]

win 下用客户端或者命令行都检出失败
Clone succeeded, but checkout failed.
linux 下无问题 是个例吗
Cloning into 'leetcode_solutions'...
remote: Enumerating objects: 141, done.
remote: Counting objects: 100% (141/141), done.
remote: Compressing objects: 100% (114/114), done.

Receiving objects: 100% (5195/5195), 13.07 MiB | 174.00 KiB/s, done.
Resolving deltas: 100% (2321/2321), done.
error: unable to create file 0057_Insert_Interval /Solution1.cpp: No such file or directory
error: unable to create file 0057_Insert_Interval /slt.md: No such file or directory
error: unable to create file 0097_Interleaving_String /Solution1.cpp: No such file or directory
error: unable to create file 0097_Interleaving_String /slt.md: No such file or directory
fatal: cannot create directory at '0597_Friend_Requests_I:_Overall_Acceptance_Rate': Invalid argument
warning: Clone succeeded, but checkout failed.
You can inspect what was checked out with 'git status'
and retry with 'git restore --source=HEAD :/'

[MarkLeeyun]

啊哈哈哈哈，难以上手而且慢。