

1. 本地环境搭建

环境说明¶

python: 3.6.6
依赖的python包:

包名模块名版本

mkdocs mkdocs 1.0.4

mkdocs-material material 3.0.6

Markdown markdown 3.0.1

pymdown-extensions pymdownx 6.0

mkdocs-material部署¶

安装¶

1	pip install mkdocs mkdocs-material

若下载慢，可更换安装源为豆瓣

1	sudo pip install --trusted-host pypi.douban.com -i http://pypi.douban.com/simple/ mkdocs mkdocs-material

初始化项目¶

1	mkdocs new my-project

会生成my-project目录，进入该目录里，可以看到默认放置了一些文件，包括mkdocs.yaml，这是主配置文件

修改主题¶

mkdocs.yml里添加:

1 2	theme: name: material

添加扩展¶

mkdocs.yml里添加:

markdown_extensions:
  - admonition
  - codehilite:
      guess_lang: false
      linenums: false
  - toc:
      permalink: true
  - footnotes
  - meta
  - def_list
  - pymdownx.arithmatex
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.emoji:
      emoji_generator: !!python/name:pymdownx.emoji.to_png
  - pymdownx.inlinehilite
  - pymdownx.magiclink
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.tasklist
  - pymdownx.tilde

可以查看我的mkdocs.yml范例，详见mkdocs.yml范例

mkdocs服务启动¶

1 2	# 在my-project目录里执行 mkdocs serve

通过浏览器打开 http://127.0.0.1:8000/ 查看效果

包名	模块名	版本
mkdocs	mkdocs	1.0.4
mkdocs-material	material	3.0.6
Markdown	markdown	3.0.1
pymdown-extensions	pymdownx	6.0