直接使用 HTML 语法

直接用 HTML 语法编写内容。

本文件就是用 html 直接写的，源码点击右上方编辑本页查看

同时支持 Jinja2 语法

{% extends "article.html" %}
注意这里 "article.html" 需要用引号引起来，不然会提示找不到 article

{% block title %}
直接使用 HTML 文件编写内容
{% endblock %}

{% block content %}
直接使用 HTML 语法
{% endblock %}

这里能看到本页面继承与article.html并且对title和content做了修改，这样就能保留导航栏和侧边栏，以及使用主题了。 具体能修改那些内容可以查看模板的源码，能够使用的模板，参考主题提供的模板文件，比如默认主题的模板文件在这里 以及页面能够使用的变量参考自定义页面模板中的变量说明。

html 文件作为模板文件使用

除了直接用 html 写页面以外，你也可以先用 html 写好模板，放到layout目录下，在.md文件中使用这个模板。 .md文件中的内容会以body变量传到html中，直接通过{{ body|safe }}使用， 这里safe表示不转义，这样在.md文件中就可以直接写 html 了。 更多自定义模板内容查看自定义页面模板。

Jupyter 语法

写文档时需注意