内容编写:Markdown、公式与 Mermaid
指南说明通用操作。当前域的权限、报名状态、时间限制及教师设置决定你能使用的选项。
正文说明
指南说明通用操作。当前域的权限、报名状态、时间限制及教师设置决定你能使用的选项。
常用格式
编辑题面、文章、讲义或总结时可以使用 Markdown。编辑器的格式提示和预览可以用来检查最终效果。
| 目标 | 写法 |
|---|---|
| 标题 | ## 二级标题,按层级组织内容 |
| 强调 | **关键结论** |
| 列表 | 每行以 - 开头,或用 1. 编号 |
| 行内代码 | 用一对反引号包围变量或短表达式 |
| 链接 | [说明文字](目标地址) |
| 图片 |  |
| 数学公式 | 按编辑器提示使用数学公式定界符 |
操作步骤
- 先搭好内容结构,再补充公式、代码和图片。
- 多行代码用三个反引号构成的围栏包起来,并填上语言,如
cpp。 - 查看预览,检查标题、列表、表格和公式显示是否正确。
- 图片使用可以访问的资源地址,并补上有意义的图片说明。
- 保存后再打开最终页面,确认实际的阅读效果。
Mermaid 图表
需要流程图时,使用语言标记为 mermaid 的代码围栏。例如在围栏内第一行写 flowchart LR,下一行写 A[读题] --> B[实现]。有效的图表会自动渲染,可以使用适应宽度、缩小、放大和原尺寸控件。
在图表区域中,可以用 +、- 缩放,0 适应宽度,1 恢复原尺寸。原生源码展开区保留可以复制的内容;出现语法错误时,可以查看源码和提示。图表配置中不能插入脚本或自定义页面样式。
常见问题
- 预览显示原代码: 检查围栏是否闭合、语言是否填写正确。
- 公式不显示: 检查定界符和公式语法,以编辑器的格式提示为准。
- 导出 PDF 与网页不同: 导出使用适合纸张的排版,下载后也需要检查公式、图片和分页。