Markdown 正文

正文使用 GitHub 风格 Markdown,不需要再写一遍 Lesson 标题——标题来自 lesson.yaml。

支持的内容

  • 表格、任务列表、脚注1
  • 行内公式 E=mc2E = mc^2 与块级公式:
Attention(Q,K,V)=softmax(QK⊤dk)V\text{Attention}(Q,K,V) = \mathrm{softmax}\left(\frac{QK^\top}{\sqrt{d_k}}\right)V
  • 带语言标注的代码块(页面上可一键复制):
def greet(name: str) -> str:
    return f"Hello, {name}!"

原生 HTML 的边界

可以使用少量 HTML,例如居中的图片:

居中示例

图 1 居中的图片

<script>、<iframe>、style 属性和 onclick 这类事件属性会被过滤掉,不会出现在页面上。

链接其他 Lesson

用相对路径指向对方的正文文件即可,例如 ID 与多语言。框架会把它改写成正确的页面地址;目标不存在时构建直接失败。

脚注

  1. 脚注会显示在页面底部。 ↩