常用的Markdown书写文档的常见示例。

标题例子(Headings Sample)

# 第一级标题

## 第二级标题

### 第三级标题

#### 第四级标题

##### 第五级标题

###### 第六级标题

块嵌套例子(Blockquote nesting Sample)

这是第一个块

这是第一个块的子块

列表例子(Lists Sample)

  • 这是列表第一行
  • 这是列表第二行
    • 这是子列表第一行
    • 这是子列表第二行

表数据例子(Data tables Sample)

第一列 第二列
第一行 第一行第一列数据
第二行 第二行第二列数据

Material是 MkDocs的一个主题。

MkDocs是一个开源的静态站点架构工具。

目录例子(Directory Sample)

一个目录结构的例子如下所示。

.
├─ mkdocs/
│  ├─ images/                            # 图片目录
│  ├─ index.md                           # 首页
│  ├─ markdown.md                        # markdown例子页
│  └─ CHANGELOG.md                       # CHANGELOG页
├─ .gitlab-ci.yml                        # CI/CD配置文件
├─ mkdocs.yml                            # MkDocs的配置文件
├─ README.md                             # 项目README

水平线例子(Horizontal rules Sample)


脚本例子(Script Sample)

下面是一个Shell的脚本例子。

$ echo $EDITOR
vim
$ pip install mkdocs-material

下面是一个yaml文件的脚本例子。

theme:
  name: 'material'