Zolto Language Support for VS Code
Syntax highlighting, live preview, diagnostics, completions, hover docs, and
formatting for Zolto — an extended-Markdown document language with
native math, diagrams, charts, vector graphics, spatial layout, and
interactive documents.
Features
- Syntax highlighting for every Zolto construct: headings, emphasis,
tables, callouts, admonitions, code fences,
@directive blocks, inline
math ($...$), @math blocks, {{variables}}, and more.
- Live preview (
Ctrl+Shift+V / Cmd+Shift+V) — a side-by-side panel
that renders your document exactly as the engine compiles it, updating
as you type.
- Diagnostics — parse errors and warnings appear as squiggles directly
in the editor.
- IntelliSense — completions for directive names and snippets,
triggered by
@ and {.
- Hover documentation for directive names.
- Format Document support.
- Export as standalone HTML — compile a
.zl file to a self-contained
.html file you can share or host anywhere.
Commands
| Command |
Description |
Zolto: Open Preview |
Open the live preview in the current editor group |
Zolto: Open Preview to the Side |
Open the live preview beside the editor (Ctrl+Shift+V) |
Zolto: Export as Standalone HTML… |
Compile and save as a .html file |
Settings
| Setting |
Default |
Description |
zolto.preview.theme |
dark |
Color theme for the preview panel (dark or light) |
zolto.validate.enable |
true |
Show parse errors/warnings as diagnostics |
Building from source
npm install
npm run compile
Then press F5 in VS Code (with this folder open) to launch an Extension
Development Host with the extension loaded, or run:
npm install -g @vscode/vsce
vsce package
to produce a .vsix file you can install via
Extensions: Install from VSIX….
What's bundled
The src/engine/ directory is the full Zolto compiler (parser, renderer,
and every subsystem: math, diagrams, charts, vectors, layout, interactive,
animation, plugins, tooling, ecosystem, theming), compiled alongside the
extension itself — there is no external runtime dependency and no network
access is required for the preview or diagnostics to work.
