MD2Wiki - Markdown to Confluence Converter
Convert your Markdown files to Confluence rich text format with one click!
Features
- Right-Click Conversion: Convert Markdown files to Confluence format with a simple right-click
- Automatic Table of Contents: Automatically inserts TOC macro at the beginning
- Mermaid Diagram Support: Preserves Mermaid code blocks (Confluence renders them automatically)
- Selection Conversion: Convert only selected text
- Configurable: Customize TOC style, auto-insertion, and notifications
Usage
Convert Entire File
- Open a Markdown file in VSCode
- Right-click anywhere in the editor
- Select "MD2Wiki: Convert to Confluence Format"
- Content is converted and copied to clipboard
- Paste (
Cmd+V or Ctrl+V) into Confluence editor
Alternative: Use Command Palette
- Open Command Palette (
Cmd+Shift+P / Ctrl+Shift+P)
- Type "MD2Wiki: Convert to Confluence Format"
Convert Selection Only
- Select text in a Markdown file
- Right-click on the selected text
- Choose "MD2Wiki: Convert Selection to Confluence Format"
- Paste into Confluence
Note: This option only appears when you have text selected.
Insert Table of Contents
- Open a Markdown file in VSCode
- Right-click in the editor
- Select "MD2Wiki: Insert Table of Contents"
- TOC macro is copied to clipboard
- Paste into Confluence
Supported Markdown Elements
- Headings (H1-H6)
- Bold and italic text
- Code blocks (with syntax highlighting)
- Mermaid diagrams
- Lists (ordered and unordered)
- Links
- Blockquotes
- Horizontal rules
- And more via GFM (GitHub Flavored Markdown)
Configuration
Access settings via Preferences > Settings > Extensions > MD2Wiki:
| Setting |
Default |
Description |
md2wiki.autoInsertTOC |
true |
Automatically insert Table of Contents at the beginning |
md2wiki.tocStyle |
"none" |
TOC list style: none, disc, circle, or square |
md2wiki.mermaidAsCodeBlock |
true |
Keep Mermaid as code blocks (recommended, Confluence handles automatically) |
md2wiki.notifyOnSuccess |
true |
Show notification when content is copied |
Commands
All commands are available via:
- Right-click menu (when editing a Markdown file)
- Command Palette (
Cmd+Shift+P / Ctrl+Shift+P)
| Command |
Description |
When Available |
MD2Wiki: Convert to Confluence Format |
Convert current file |
Markdown files |
MD2Wiki: Convert Selection to Confluence Format |
Convert selected text only |
Markdown files with selection |
MD2Wiki: Insert Table of Contents |
Insert TOC macro |
Markdown files |
Examples
Before (Markdown)
```markdown
My Document
Overview
This is a sample document with some formatting.
```javascript
console.log('Hello, World!');
```
```mermaid
graph TD
A[Start] --> B[End]
```
```
After (Confluence)
- Automatic Table of Contents at top
- Proper heading hierarchy
- Code block with JavaScript syntax highlighting
- Mermaid diagram rendered natively in Confluence
Requirements
- VSCode 1.80.0 or later
- Confluence account with editor access
Known Issues
- Very large files (>10MB) may take a few seconds to convert
- Some advanced Markdown extensions may not be fully supported
Release Notes
0.1.0
- Initial release
- Basic Markdown to Confluence conversion
- TOC and Diagram macro support
- Mermaid diagram support
- Configurable options
Contributing
Found a bug or want a feature? Open an issue!
License
MIT
Enjoy converting your Markdown to Confluence! 🚀
| |
