正文使用 GitHub 风格 Markdown,不需要再写一遍 Lesson 标题——标题来自 lesson.yaml。
支持的内容
- 表格、任务列表、脚注1
- 行内公式 与块级公式:
- 带语言标注的代码块(页面上可一键复制):
def greet(name: str) -> str:
return f"Hello, {name}!"
原生 HTML 的边界
可以使用少量 HTML,例如居中的图片:
图 1 居中的图片
<script>、<iframe>、style 属性和 onclick 这类事件属性会被过滤掉,不会出现在页面上。
链接其他 Lesson
用相对路径指向对方的正文文件即可,例如 ID 与多语言。框架会把它改写成正确的页面地址;目标不存在时构建直接失败。
脚注
-
脚注会显示在页面底部。 ↩