LiaScript 在线学习：目的、用法、答题特色与常用资源

LiaScript在线学习平台、LiaScript答题特色和LiaScript平台上常用资源，轻量但非常实用平台，实时运行代码和现场答题，在LiaScript下也有非常多的常用资源帮助制作教材的朋友。很多做培训、写教程的朋友都遇到过同一个困境：课件做完就“死”了，学员只能看，不能练；想加几道练习题，又要折腾各种平台和账号。LiaScript要解决的，正是这个问题——用一个 Markdown 文件，把“看课”和“练题”放在同一份纯文本里，浏览器打开就能用，不依赖任何学习管理系统。

一、LiaScript 的目的

前几天用GDScript的在线学习网站学习，看过知识点后可以答题，在网页内现场答题还能运行代码，觉得这样的风格好，就用DeepSeek搜索出来LiaScript。用WorkBuddy组织教材后，实验运行效果满意。

LiaScript 的出发点很朴素：在线学习内容不应该被锁在昂贵的平台里，也不应该“录完就过时”。它想做的是一种像开源软件一样运作的课程格式——可版本化、可翻译、可复用、可社区协作。

具体来说，它服务于三类人：

教师/培训者：用结构化 Markdown 写课，顺便把测验、动画、语音朗读、可运行代码嵌进去，不需要先成为 Web 开发者。

公益组织/非营利机构：分发多语言、低带宽友好的内容，免费、可自行托管，不受商业平台条款限制。

开发者/技术写作者：用可执行代码和旁白来教编程、写 API 文档——代码块不只是高亮，是可以当场改、当场跑的。

一句话概括 LiaScript 的定位：它让一份 Markdown 文件同时成为“讲义”“幻灯片”和“练习册”，在浏览器里离线也能跑，没有付费层级，也不需要注册账号。

二、LiaScript 的基础用法

LiaScript 首先是一个扩展的 Markdown 方言。普通 Markdown 能写的，它都能写；普通 Markdown 写不了的“交互”，它用很少的额外语法补上。

① 一个最小的可运行文件。把下面几行保存成 course.md，托管到 GitHub，用 LiaScript 的在线解释器打开链接，一门带测验的课就成立了：

# 我的第一门 LiaScript 课 {{|>}} 欢迎来到交互课程。 2 + 2 等于多少？ - [( )] 3 - [(X)] 4 - [( )] 5

注意两个东西：{{|>}} 会给这一页加上语音朗读入口；- [(X)] 就是一道单选，(X) 标记正确项，( ) 是干扰项。整个测验只用 Markdown 列表就写完了，没有 JSON，没有外部组件。

② 浏览器的 LiveEditor 可以直接试。打开 LiaScript 的 LiveEditor，粘贴上面内容，点解析就能看到效果，不需要在本地安装任何东西。对于备课阶段反复调格式，这是最省事的入口。

③ 代码块可以被“激活”。给代码块加上对应的模板导入，它就从“只读示例”变成可编辑、可执行的练习区。JavaScript、Python（通过 Pyodide）、SQL 等都可以在浏览器里直接跑，不依赖后端服务器。

④ 导出不是死路。如果机构已经在用 Moodle、ILIAS 等 LMS，LiaScript 可以通过 Exporter 把课程打包成 SCORM 或 IMS，也可以导出 PDF 和独立网页项目，不会因为“选了 LiaScript”就把内容锁在浏览器里。

机器上安装有Node.js，就可以使用LiaScript。

• 操作步骤：

  1. 安装 Node.js。

  2. 在终端中全局安装：npm install -g @liascript/devserver。

  3. 在包含你课程 Markdown 文件的目录下，直接运行 liascript-devserver 或简写 liadev 即可。

  4. 打开浏览器访问 http://localhost:3000 就能看到你的课程。

• 附加价值：它还支持 --live 参数开启文件修改后的实时重载，非常适合边写边看。

• 局域网共享：启动后，它还会显示一个局域网地址（如 http://192.168.x.x:3000），同一网络下的其他设备（如手机、平板）也能直接访问，方便小范围测试。

 

启动后界面如下：

教材内容可以用支持markdown格式的编辑器来更新修改，非常方便。

另外markdown的分级形式被LiaScript解释为教材目录，把目录难题也一并解决了，这也是优点。

LiaScript对中文内容支持非常好，目录、知识点和题目里中文都显示正常。

三、LiaScript 的答题特色

答题是 LiaScript 跟普通 Markdown 最不一样的地方，也是它作为“学习工具”而不是“排版工具”的核心。

题型直接写在行文里。LiaScript 的测验不要求你跳到另一个“题库界面”。单选题用列表 - [(X)]，填空题用 [[答案]]，选择题用 [[ 干扰项 | (正确项) | 干扰项 ]]，正确选项用圆括号包住即可。矩阵题、下拉选择、完形填空都共享同一套括号逻辑。学习者在阅读一段讲解之后，紧接着就能检验自己，不需要离开上下文。

提示和解析是“按需展开”的。任何一道题后面都可以挂若干条 [[?]] 提示，学习者卡住时逐条点开，而不是一上来就看到答案。题目做完之后，还可以用 *** 围出一段“解析区”，把为什么对、为什么错讲清楚，解析区里甚至可以继续嵌套代码块和 Markdown 元素。

代码题是真的能跑的。这是 LiaScript 区别于大多数 Markdown 测验工具的地方。编程课的练习块可以被设为可编辑、可运行，学习者改一行代码、跑一下、看到输出变了，再对照题目要求判断自己是否做对。整个过程在浏览器里完成，不需要装环境、连远程服务器。

还支持“不评分的问卷”和“随机出题”。除了正式测验，LiaScript 也有 survey 块，用于收集反馈而不判对错。如果希望练习不“背题”，可以用 Random 模板把一组题目包起来，设置每次访问随机抽几道、按权重抽，或者只抽还没做对过的题。

无障碍也被考虑进去了。把问题写成普通 Markdown 段落、测验紧跟其后，LiaScript 会把两者关联起来，屏幕阅读器能正确播报“这道题问的是什么”，而不是只读出一串孤立的选项。

题目选项选择后，点检查按钮就给出结果，非常快捷。

四、LiaScript 常用资源搜集

对于想复用教材的，看https://github.com/LiaBooks，里面有一些示例资源。

LiaScript 的生态不算庞大，但入口集中、维护公开，上手时盯住几个关键资源就够了。

官方入口与文档：主站 liascript.github.io 提供 About、Blog、Docs 和 LiveEditor 的统一入口。完整文档覆盖语法、模板、测验和脚本，是查细节的第一站。

LiveEditor：浏览器内的在线编辑器，支持新建、上传 Markdown/ZIP、从 GitHub 仓库或 Gist 导入，适合边写边看效果，也适合直接把示例分享给同事。

LiaTemplates 模板库：GitHub 上的 LiaTemplates 组织维护了大量可复用的模板，涵盖代码执行、PlantUML、Scratch、SQL、3D 可视化、化学结构等。用法是“导入模板 → 按模板约定写代码块”，不用从零实现交互逻辑。

Exporter：需要离线分发或对接 LMS 时，用 Exporter 把课程导出为 PDF、SCORM、IMS 或独立 Web 项目。有 CLI 和 npm 包两种方式，适合批量处理或集成到构建流程里。

教学 Agent：LiaScript 项目还发布了一个用于辅助课程编写的 teaching agent，采用“先定目标、受众和教学法，再生成材料”的流程，并支持从同一份规格生成 Claude Code、Copilot、Cursor 等不同编辑器的配置。仓库里附带的 NIS2 课程可以作为完整示例参考。

社区与源码：主解释器在 github.com/LiaScript/LiaScript，BSD-3-Clause 许可，机构可以自行托管和修改。遇到问题走 GitHub Discussions / Issues，比在搜索引擎里翻零散答案更可靠。

如果你已经在用 WorkBuddy 之类的工具批量生成 LiaScript 课程，可以把上面“答题特色”里的题型和提示/解析语法当作数据格式约束写进对话，让模型直接产出可用的 .md 文件，省去大量后期手工调整。