用途:按特定格式规则创建 MATLAB 纯文本 Live Script(.m 文件),把可执行代码与富文本说明合并在同一文件中,适合生成教学类 MATLAB 内容、教程或带文档的示例脚本。
主要能力与规则:文件必须使用 .m 后缀,禁止创建二进制 .mlx;每个脚本必须以固定附录结尾:%[appendix]{"version":"1.0"}、%---、%[metadata:view]、% data: {"layout":"inline"}、%---。章节标题须写成 %% 单独一行,下一行用 %[text] ## 标题,不能写成 %% 标题。正文用 %[text] 前缀并支持 Markdown;文件内不留空行;项目符号列表最后一项需以反斜杠结尾;表格用 %[text:table] 包裹;LaTeX 公式中所有反斜杠需双写。面向读者的说明用 %[text],不要用 fprintf。绘图使用隐式创建(直接调用 plot、histogram 等),不要用 figure 命令;每节最多一个图,除非用 tiled 布局且确有必要。脚本开头不要用 close all 或 clear。
使用方式:按“标题与简介—初始化代码—带说明的章节—必需附录”的结构组织脚本。读取 Live Script 时可忽略 %[appendix] 以下内容以节省 token,因为工作代码与文本都在附录之前。
限制与排查:若富文本显示异常,检查每行文本是否以 %[text] 开头;公式不渲染时检查反斜杠是否双写;章节异常时确认 %% 独占一行;无法保存输出时核对附录格式与缩进。具体安装或调用方式暂未提供。