MDMA Language Support — VSCode Extension

Provides syntax highlighting, bracket matching, and snippets for .mdma (Markdown Mapped) files. See the language specification and docs for the full grammar and filter reference.

Features

• Syntax highlighting for:

  • @inputs section and typed declarations
  • Block headers <blockname>
  • Multi-line block headers with multiple: x in list / name: expr modifiers
  • Template interpolation {{ }}, control tags {% %}, and comments {# #}
  • Template keywords (if, for, elif, else, endif, endfor, in, not, and, or)
  • Filter functions (length, join, lower, etc.)
  • Markdown content within blocks (headings, bold, italic, blockquotes, code)

• Bracket auto-closing for {{ }}, {% %}, and {# #} pairs, plus comment toggling (Ctrl+/) using {# ... #}

• Type declaration generation on save — for a template in a TypeScript project (one with an ancestor tsconfig.json), writes/refreshes its foo.d.mdma.ts under a .mdma-types/ folder at that project's root, mirroring the template's relative path, so import types stay in sync without running mdma-typegen by hand. Pair it with a rootDirs entry in that tsconfig.json (see the typescript-mdma docs) so import x from "./foo.mdma" resolves the generated types, and gitignore .mdma-types/ since it's regenerated on every save. Templates outside any TypeScript project are left untouched.

• Snippets — trigger with the prefix in any .mdma file:

  Prefix	Description
  @inputs	Full file skeleton
  input	Single input declaration
  block	Named block header
  multiple	Block with a multiple header modifier
  multiplename	Block with multiple and name header modifiers
  if	Conditional block
  ifw	Conditional list section with whitespace control
  for	For loop
  forw	For loop with whitespace stripping
  {{	Interpolation tag
  {#	Comment
  breaking	Breaking change blockquote

Installation

Development install (no packaging required)

cp -r /path/to/mdma-vscode ~/.vscode/extensions/mdma-language-0.1.0

Then reload VSCode (Ctrl+Shift+P → Developer: Reload Window).

Package and install with vsce

npm install -g @vscode/vsce
vsce package
code --install-extension mdma-language-0.1.0.vsix

Theme Compatibility

The extension uses standard TextMate scopes, so it works with any theme. Key scopes: