You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

多章节Markdown测评文档子模块拆分方案及通用规范咨询

测评类Markdown模块的通用实现方案

目前没有被CommonMark官方标准化的习题/测评模块格式,但有两个在技术文档、在线教育领域被广泛使用的行业约定方案:

  • MyST Markdown 指令块方案:在学术出版、技术教程领域应用最广,直接用语义化的代码块划分模块,无需自定义分隔符:
    • 用 {exercise} 代码块包裹题目和选项,选项直接使用标准 GitHub Flavored Markdown(GFM)的任务列表语法(- [ ]/- [X]),多行选项只要缩进对齐即可自动识别
    • 用 {solution} 代码块包裹答案和解析,渲染时可以配置为默认隐藏、点击展开
      这个方案的优势是完全兼容现有Markdown生态,普通解析器会把指令块渲染为普通代码块,支持MyST的解析器可以直接识别为习题组件。
  • 教育平台通用导入格式:绝大多数支持Markdown导入习题的在线教育平台,都会采用「普通段落写题目+GFM任务列表写选项+HTML折叠块写答案」的方案,完全不需要自定义语法,所有通用Markdown渲染器都能正常展示:
    以下哪个是Linux系统的默认用户shell?
    - [ ] sh
    - [X] bash
      支持命令补全、历史记录扩展等特性,是绝大多数发行版的默认配置
    - [ ] zsh
    - [ ] powershell
    
    <details>
    <summary>查看答案</summary>
    正确答案:B
    解析:bash是GNU项目推出的sh兼容实现,从90年代开始就是多数Linux发行版的默认shell,zsh、fish等扩展shell需要用户手动安装启用。
    </details>
    

自定义分隔符方案的优化建议

如果你是内部工具自用,不需要兼容通用渲染器,用$$$做分隔符是可行的,但有两个优化点:

  • 建议更换为+++或者===这类独占一行的分隔符,避免和正文里的LaTeX数学公式符号$冲突,减少转义成本
  • 不需要额外设置选项拆分符号,直接用GFM任务列表的- [ ]/- [X]标记即可,本身已经自带正误标识,也支持多行内容(子行缩进2/4个空格即可),写正则匹配提取的成本也极低。

示例结构参考

按照你提到的整体文档结构,兼容通用标准的完整示例如下:

---
# YAML Frontmatter
title: 计算机基础第一章测评
version: 1.0
create_time: 2024-05-01
---
# 理论说明
本章讲解操作系统的基础概念、Shell的核心作用与常见分类。
---
## 测评1
```{exercise}
:id: 1
以下哪个是Linux系统的默认用户shell?
- [ ] sh
- [X] bash
  支持命令补全、历史记录扩展等特性,是绝大多数发行版的默认配置
- [ ] zsh
- [ ] powershell
查看答案 正确答案:B 解析:bash是GNU项目推出的sh兼容实现,从90年代开始就是多数Linux发行版的默认shell,zsh、fish等扩展shell需要用户手动安装启用。
--- ```

内容的提问来源于stack exchange,提问作者Miguel Moura

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.29 10:36:04