1.安装mkdocsspipinstallmkdocs2.创建项目mkdocsnewtestdocs3.文档预览mkdocsserve4.更改主题下载主题pipinstallmkdocs-materialmkdocs-windmillmkdocs.ymlAdd:theme:name:'material'5.执行mkdocs.yml配置site_name:MyDocssite_description:OnlineCloudDocumentationsite_author:Xiaokangcopyright:Copyright?2022-2099Xiaokangsite_url:https://mkdocs.codeslive.top/repo_url:https://github.com/codeslive/mkdocsrepo_name:mkdocsedit_uri:""#theme配置theme:name:materiallanguage:ensearch_index_only:truepalette:-media:"(prefers-color-scheme:light)"scheme:defaulttoggle:icon:material//weather-sunnyname:切换到黑暗模式-media:"(prefers-color-scheme:dark)"primary:tealscheme:slatetoggle:icon:material/weather-nightname:Switchtolightmodefeatures:#-navigation.instant#当点击内部链接时,不刷新所有页面-navigation.tracking#使用url中的title定位锚点-navigation.tabs#在顶部(即第一个)显示导航topnavnodes)-navigation.tabs.sticky#scrolling是为了隐藏顶部nav,需要和navigation.tabs一起使用-navigation.sections#navnodeindentation-navigation.expand#不折叠左边的navnode-navigation.indexes#指定节点索引页面,不兼容instant-toc.integrate#制作目录在右边-toc.integrate#导航集成-navigation.top#一键返回顶部-header.autohide-search.share#搜索分享-search.suggest#搜索建议-search.highlight#搜索高亮插件:-search:jieba_dict:user_dict.txt#iconicon:admonition:note:octicons/tag-16abstract:octicons/checklist-16info:octicons/info-16提示:octicons/squirrel-16成功:octicons/check-16问题:octicons/question-16警告:octicons/alert-16失败:octicons/x-circle-16危险:octicons/zap-16错误:octicons/bug-16示例:octicons/beaker-16quote:octicons/quote-16#Extendedmarkdown_extensions:-admonition-pymdownx.details-pymdownx.superfences-缩写-pymdownx.snippets-def_list-表格-pymdownx.tasklist:custom_checkbox:true-attr_list-md_in_html-meta-pymdownx.highlight:anchor_linenums:true-pymdownx.inlinehilite-pymdownx.caret#underline-pymdownx.mark#texthighlight-pymdownx.tilde#画线#Customcssextra_css:-'//cdn.staticaly.com/gh/codeslive/cdn@main/css/imageszoom.css'#imagezoomcss#-'//cdn.staticaly.com/gh/codeslive/images-pages@main/cdn/css/custom.css'#-'//cdn.staticaly.com/gh/codeslive/images-pages@main/cdn/css/simplelightbox.min.css'#imageenlargementcss#customjsextra_javascript:-'//cdn.staticaly.com/gh/codeslive/cdn@main/js/busuanzi.pure.mini.js'#网站访问统计-'//cdn.staticaly.com/gh/codeslive/cdn@main/js/imageszoom.js'#图像缩放js#-'//cdn.staticaly.com/gh/codeslive/cdn@main/js/jquery-3.2.1.min.js'#-'//cdn.staticaly.com/gh/codeslive/cdn@main/js/simplelightbox.min.js'#Imageenlargementjs#-'//cdn.staticaly.com/gh/codeslive/cdn@main/js/custom.js'#Setextra:social:-图标:fontawesome/brands/github链接:https://github.com/codeslive名称:github-图标:fontawesome/brands/slack链接:https://codeslive.github.io名称:myblog-图标:fontawesome/solid/paper-plane链接:2783779285@qq.comname:邮箱#文档区nav:-文档介绍:'index.md'-'在线云文档':-'静态云文档':-mkdoc:'mkdocs.md'-docsify:'docsify.md'-'动态云文档':-leanote:'leanote.md'-mrdoc:'mrdoc.md'-showdoc:'showdoc.md'-个人博客建设:-'静态博客':-hexo:'hexo.md'-vuepress:'vuepress.md'-'动态博客':-halo:'halo.md'-worldpress:'worldpress.md'-开发记录:'record.md'部署站点1.打包命令mkdocsbuild2.添加仓库gitinitgitremoteaddoriginghrepoclonecodeslive/mkdocs3.上传mkdocsgh-deploy或mkdocsbuild--clean&&mkdocsgh-deploy6.相关教程快来美化你的MKDocsmkdocs-material7.演示白天模式夜间模式文章由mdnice多平台发布
