Agent skill

mpe

Reference knowledge for Markdown Preview Enhanced (MPE) VS Code extension. Covers settings, code chunks, file imports (@import), diagram engines (Mermaid, PlantUML, GraphViz, Vega-Lite, Kroki, WaveDrom), reveal.js presentations, export pipelines (PDF, HTML, Pandoc, eBook), and custom CSS styling. Use when the user is working with MPE, asking about MPE features, configuring preview settings, embedding diagrams, building slides, exporting documents, or troubleshooting issues like preview not rendering or export failing. Do not use for general Markdown syntax or other VS Code extensions.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/nathanvale/side-quest-marketplace/tree/main/plugins/kb-mpe/skills/mpe

SKILL.md

MPE Knowledge Hub

Reference knowledge for Markdown Preview Enhanced (MPE), a VS Code extension for advanced Markdown previewing and exporting. MPE uses the crossnote rendering engine.

Routing Table

User Intent Reference Quick Hint
Configure VS Code settings / extension options settings.md markdown-preview-enhanced.* in settings.json
Execute code in preview / {cmd} blocks / output modes code-chunks.md Requires enableScriptExecution: true
Import files, images, or other markdown into a doc file-imports.md @ import "path" syntax (no space in actual use)
Embed diagrams (Mermaid, PlantUML, GraphViz, etc.) diagrams.md Fenced code blocks with engine name
Build reveal.js presentations / slides presentations.md <!-- slide --> separator
Export to PDF, HTML, eBook, or PNG export.md Right-click preview > Export
Style the preview / custom CSS / dark mode custom-css.md Edit style.less via Customize CSS command

Quick Reference

Top 5 Settings

Setting Default Purpose
previewTheme github-light.css Preview color scheme
codeBlockTheme auto.css Syntax highlight theme
enableScriptExecution false Allow {cmd} code chunks
mermaidTheme default Mermaid diagram theme
mathRenderingOption KaTeX Math engine (KaTeX or MathJax)

Code Chunk Quick Syntax

```python {cmd=true output="markdown"}
print("| Col A | Col B |")
```

Run current chunk: Shift+Enter | Run all chunks: Ctrl+Shift+Enter

File Import Quick Syntax

@ import "path/to/file.md"

(Remove space after @ in actual use -- escaped here to prevent loader execution.)

Common Questions

  1. Preview not rendering? Check editorAssociations in settings.json -- VS Code bug #192954 can override MPE. Fix: set "*.md": "default" in editorAssociations.

  2. Code chunks not executing? Set enableScriptExecution: true in VS Code settings. Security risk -- only enable in trusted workspaces.

  3. Diagrams not showing? PlantUML requires Java on PATH. Mermaid/GraphViz work out of the box. Kroki requires internet (external service).

  4. PDF export failing? Puppeteer needs Chrome/Chromium. Set chromePath if auto-detection fails. See export.md.

  5. Custom CSS not applying? Run "Markdown Preview Enhanced: Customize Css" from Command Palette. Edits ~/.crossnote/style.less (global) or workspace .crossnote/style.less.

  6. Config.js vs settings.json? VS Code settings.json controls extension behavior. Crossnote config.js controls rendering engine. Access config.js from Command Palette: "MPE: Open Crossnote Config".

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

nathanvale/side-quest-marketplace

cli-mcp-decision

Decide whether a workflow should use CLI skills, MCP, or a hybrid approach. Use when planning agentic tooling, writing ADRs, or evaluating migrations between CLI and MCP.

0 0
Explore
nathanvale/side-quest-marketplace

agent-cli

Patterns for building CLIs that serve both humans and AI agents. Covers tri-modal output (JSON/JSONL/human), typed exit codes, structured error contracts, zero-dependency arg parsing, topic-based help, service discovery, field projection, and auto agent-mode detection. Reference implementation: @side-quest/observability CLI. Use when: building a CLI, adding a command, CLI output format, agent-friendly CLI, machine-readable output, JSON CLI contract, exit codes, --json flag, NDJSON streaming, how should my CLI work with agents, CLI design patterns.

0 0
Explore
nathanvale/side-quest-marketplace

explain-codebase

Generate an engaging, deep-dive explanation document (FOR_[NAME].md) that explains a codebase or domain in plain language with analogies, lessons learned, and practical wisdom.

0 0
Explore
nathanvale/side-quest-marketplace

vscode-bookmarks

Create and manage VS Code Bookmarks extension labeled bookmarks in .vscode/bookmarks.json. Use when the user wants to add navigation bookmarks to a codebase, trace data flows through code, mark important code locations, or set up labeled waypoints for code walkthroughs. Also use when user says "bookmark", "label this code", "mark this flow", or "add waypoints".

0 0
Explore
nathanvale/side-quest-marketplace

manage-plugins

Add or remove inline plugins from the ccdev function in dotfiles .zshrc

0 0
Explore
nathanvale/side-quest-marketplace

observability

Start, stop, or check status of the Side Quest observability event server. Use when asked to start the server, stop the server, check server status, or manage the observability dashboard lifecycle.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results