MaraudersMapMD — AI-Native Markdown Preview for Cursor & Antigravity
If you're working with AI coding assistants like Cursor or Antigravity, you've probably noticed that most Markdown tooling wasn't built with AI workflows in mind. Your AI assistant reads your docs, but it has no way to understand their structure efficiently. That's exactly the problem MaraudersMapMD solves.
What Is MaraudersMapMD?
MaraudersMapMD is a VS Code extension that gives you ultra-fast Markdown preview with a twist: it generates AI-native readability artifacts that help your AI assistant comprehend your documentation at a structural level — without calling any external APIs.
Think of it as giving your AI a map of your document, so it doesn't have to read the entire thing every time.
Key Features
AI Readability (GEO)
When you save a Markdown file, MaraudersMapMD automatically builds a set of artifacts into a docs/MaraudersMap/ directory:
- AI Map (
ai-map.md): A document structure overview with heading hierarchy and token estimates - Section Pack (
sections/*.md): Your document split by headings for precise LLM consumption - Search Index (
index.json): Keywords and semantic markers per section - AI Hint Blocks: Semantic markers like
[AI RULE],[AI DECISION],[AI CONTEXT], and[AI TODO]that your AI assistant can interpret
All of this happens locally — no API calls, no cloud dependencies. It's completely vendor-neutral, meaning any AI tool can read the generated artifacts.
Real-Time Preview
The preview is built for speed. Configurable debounce (default 200ms), scroll sync between editor and preview, dark/light mode optimization, and smart handling of large documents with adaptive delay.
Export
Export your Markdown to PDF (via system Chrome/Chromium, auto-detected) or standalone HTML with embedded images. Configurable margins, paper formats (A4/Letter/A3/A5), and background printing options.
Document History
Automatic snapshots on save, configurable intervals, manual checkpoints with labels, a visual diff viewer, and one-click restore. All stored with gzip compression.
What's New (v1.1.23 — Feb 2026)
The latest release brings several notable updates:
- PPT Prompt: New functionality for generating presentation PDFs directly from your Markdown
- Mermaid Diagram Support: Full Mermaid rendering via CDN with enforced light mode for exports
- Image Copy Command: Quickly copy image links from your document
- Enhanced PDF Export: More options and improved syntax highlighting in preview
Installation
Search "MaraudersMapMD" in the VS Code / Cursor / Antigravity Extensions panel (Open VSX Registry), or download the .vsix from GitHub Releases and install manually:
code --install-extension marauders-map-md-1.0.0.vsix
Why You Should Try It
If you write documentation alongside AI, this extension fundamentally changes the workflow. Instead of your AI assistant guessing at document structure from raw text, it gets a clean, tokenized map of your content. The result? More accurate AI responses, less wasted context window, and a preview experience that's genuinely fast.
It's MIT-licensed, open source, and actively maintained. Give it a spin and see the difference.