MD Manager for VS Code

MD Manager is a Visual Studio Code extension designed to manage, organize, inspect, and view Markdown and Changelog files across your project. It features native PDF document export, a live Table of Contents outline, drag-and-drop file operations, and automated TOC management.

❓ Why MD Manager?

Managing documentation, notes, changelogs, and technical specs across large software projects often means dealing with scattered Markdown files and navigating complex folder trees.

MD Manager brings structure and speed to your Markdown workflow inside VS Code:

• 🚀 Centralized Navigation: Discover and organize all .md, .markdown, and CHANGELOG files in a dedicated Activity Bar panel.
• 📑 Live Outline Tracking: Jump across headings effortlessly with an active Table of Contents panel that stays in sync even during Markdown preview.
• 📄 1-Click Native PDF Generation: Transform single files or entire folders into print-ready PDF documents with customizable styling themes.
• 📂 Effortless Organization: Drag and drop files to reorganize folders on disk with built-in safety confirmation prompts.

🚀 Getting Started

1. Open the Activity Bar: Click the MD Manager icon on the left Activity Bar to open the Markdown Files and Outline panels.
2. Explore Workspace Documents: Click any document to open it in the text editor or side-by-side preview.
3. Export to PDF: Right-click any Markdown file or folder in the tree view and select Export to PDF... or Export Folder to PDF....

💻 Installation

Option 1: VS Code Marketplace

1. Open VS Code and press Ctrl+P (or Cmd+P on macOS).
2. Type ext install jeddak.md-manager and press Enter.
3. Alternatively, search for MD Manager in the Extensions View (Ctrl+Shift+X).

Option 2: Open VSX Registry

For VSCodium or Open VSX-compatible editors:

ovsx get jeddak.md-manager

Option 3: Manual VSIX Installation

Download the latest md-manager-0.1.0.vsix package and run:

code --install-extension md-manager-0.1.0.vsix

🌟 Key Features

📁 1. Markdown Explorer Panel (md-manager-explorer)

• Automatic File Discovery: Index .md, .markdown, .mdown, .mkdn, CHANGELOG.md, changelog.md, CHANGELOG, and CHANGES files automatically.
• Multi-Root Workspace Support: Group files under distinct project root folders when working in multi-root workspaces.
• Dynamic View Modes: Toggle between Folder Hierarchy (Tree) and Flat List view modes with dynamic toolbar icon indicators (list-flat / list-tree).
• Expand All / Collapse All Toggle: Instantly expand or collapse all tree folders with a single dynamic toolbar action.
• Folder Context File Creation: Create new Markdown files directly within any selected folder via the right-click context menu.
• File Deletion with Confirmation: Delete Markdown files with modal safety confirmation dialogs.
• Drag-and-Drop File Relocation: Drag Markdown files onto target folders in the tree view to move them on disk, complete with confirmation dialogs.
• Rich Document Metadata Tooltips: Inspect word count, line count, estimated reading time, file size, last modified date, and heading summaries in interactive tooltips.

📄 2. One-Click Native PDF Document Export

• Single File Export: Convert any Markdown file into a native, print-ready binary .pdf document using system headless browser printing.
• Folder Merging Export: Right-click any folder to merge all Markdown documents inside into a single .pdf document with an automated cover page and table of contents index.
• 4 Custom Styling Themes:
  • 📄 GitHub Paper (Light): Classic GitHub GFM white paper styling with crisp borders.
  • 🌙 Modern Dark (Sleek): Dark presentation theme with vibrant accents and glassmorphic container styling.
  • 🎓 Academic Serif: Thesis layout with Georgia serif typography and indented blockquotes.
  • 💼 Enterprise Executive: Corporate navy blue headers with structured data tables.

📑 3. Document Outline Panel (md-manager-outline)

• Real-Time Outline Tree: Interactive Table of Contents panel displaying #, ##, ### headings for the active document.
• Markdown Preview Mode Tracking: Retains document outline state while previewing rendered documents in VS Code.
• Code Block False Positive Filtering: Excludes # comments inside fenced code blocks (``` / ~~~) from appearing as false headings.
• One-Click Jump Navigation: Jump directly to target heading lines in the editor.

🛠️ 4. Automated Table of Contents (TOC) Management

• Insert / Update TOC Block: Generate GFM-compatible Table of Contents blocks with slug anchor links (<!-- TOC --> ... <!-- /TOC -->).
• Remove TOC Block: Remove existing TOC blocks using the conditional trash toolbar action (md-manager:hasTOC).

⚙️ Extension Settings

Customize MD Manager via Settings -> Extensions -> MD Manager (md-manager):

💻 Contributed Commands

🔗 Looking for other useful extensions?

Check out the Md Kanban to manage your tasks in Markdown files.

📄 License

MIT License © 2026 Jebakumar (Publisher: jeddak).

Co-authored with Antigravity.