Create fully interactive, offline-capable online courses using Markdown – perfect for educators, NGOs, and developers.
LiaScript is an open-source interpreter that turns static Markdown files into fully interactive learning experiences – rendered directly in the browser, even offline. It’s built for:
- 🎓 Educators: Craft structured lessons with quizzes, animations, TTS, and live code.
- 🌍 NGOs: Distribute multilingual, low-bandwidth-friendly content, globally and for free.
- 💻 Developers: Document APIs or teach programming with executable code and narration.
Hello.LiaScript.mp4
- ✅ Plain Markdown-compatible with educational extensions
- ❓ Quizzes, cloze tests, and surveys
- 🗣️ Text-to-Speech (TTS) in multiple languages
- 💻 Live Code execution (JavaScript, Python via Pyodide, MicroPython, etc.)
- 📊 ASCII diagrams, charts, and tables
- 📲 PWA support – works completely offline
- 📤 Export to PDF, SCORM, IMS
- 🔌 Plugin system and macros
- 👥 Peer-to-Peer mode for offline-first collaboration
- much more ...
-
Create a Markdown file:
# Hello LiaScript {{|>}} Welcome to this interactive course. What is 2 + 2? - [( )] 3 - [(X)] 4 - [( )] 5
-
Host it (e.g., on GitHub)
-
Open it in your browser:
https://liascript.github.io/course/?https://github.com/yourname/my-course/README.md
-
Open the LiveEditor
-
Change the example and click on parsing
-
Export it to GitHub gist, Nostr, or share it directly as a data-URI (only within the URL).
| Resource | Description |
|---|---|
| Blog | News, features, tutorials, examples and more |
| LiveEditor | Online & browser only editor for LiaScript |
| Docs | Full documentation, syntax, tutorials |
| YouTube Channel | Video guides & examples |
| Exporter-CLI | PDF/SCORM/IMS/WEP/Project exporter |
| Markdownify JSON -> LiaScript | AI-compatible JSON course generator |
| VSCode Preview Plugin | Live Preview courses in VSCode |
| VSCode Web-Preview Plugin | Live Preview courses in VSCode-Web (https://github.dev) |
| Atom Preview Plugin | Live Preview courses in Atom |
| Development Server | Lvve Preview courses with any editor |
- Ask questions in GitHub Discussions
- See what others are building in LiaScript Courses
- Create your own extensions and share them LiaScript Templates
- Found a bug or have an idea? → Open an issue
- Extend the internationalization: Create or correct a Translation
We welcome collaborations with:
- 📚 Open Education Initiatives
- 🌱 Non-profit training programs
- 🏫 Teachers & universities worldwide
Let’s build a global library of interactive knowledge.
- Use our Exporter-CLI to export courses to PDF/SCORM/IMS/Index/Web
- Automate deployment with GitHub Actions (Examples)
- Convert AI-generated JSON to Markdown using Markdownify
Licensed under the BSD3 License – 100% free and open.
- ✉️ Newsletter: Typeform
- 💬 Twitter: @LiaScript
- 📫 Email: LiaScript@web.de
“Markdown is just text – LiaScript turns it into learning.”
Use the following commands to download the LiaScript source-code and to build it locally.
git clone https://github.com/liascript/liascript
cd liascript
npm i
npm run watch # develop in watch-mode
npm run build # build to distAfter your first build, you can run the following commands, this will download additional elm-patches and apply them:
git submodule update --init --recursive
cd patches
make
cd .. # go back
rm -rf elm-stuff .parcel-cache # remove all cached stuff
npm run build # force an entire rebuild of the projectThis will apply the following four patches:
-
elm-break-dom: allows browser extensions such as screen-readers to change the nodes of the app, without crashing the app
-
elm-patch/url: enables the file-protocol, which is only required when building Desktop-apps
-
elm-patch/dom: enable onclick events as well as innerHTML
-
Dexie: this will allow only LiaScript to access indexedDB, which increases the security, by restricting the access. This way information about user states, visited courses, etc. cannot be leaked or spied by other JavaScript modules.
If you want to add a preview-link for the course to your site, simply add the
following script to the head of your website and place the custom webcomponent
preview-lia anyone in your document, with src pointing to your LiaScript
course.
<html>
<head>
...
<!-- add preview-lia tag support to display all course related information -->
<script
type="text/javascript"
src="https://liascript.github.io/course/preview-lia.js"
></script>
...
</head>
<body>
...
<preview-lia
src="https://raw.githubusercontent.com/liaScript/docs/master/README.md"
></preview-lia>
...
</body>
</html>Simply replace URL at the end of the snippet below with your desired GitHub
repository (and the main README.md of your master-branch will be used) or
directly point to any Markdown-file anywhere within the web.
Badges:
-
course:
[](https://LiaScript.github.io/course/?URL) -
learn more:
[](https://LiaScript.github.io/course/?URL)