How To Use & Features

Markdown Importer for Confluence comes with a rich set of features to make your documentation migration smooth and efficient.

Bulk Import

Import multiple markdown files at once:

1. Navigate to any Confluence page
2. Click the ••• (More actions) menu
3. Select "Markdown Importer"
4. Choose multiple files (up to 50)
5. Click "Import"

The files will be imported in the order they were selected.

Preview Support

Preview your markdown files before importing:

1. Select your markdown file(s)
2. Click "Preview" instead of "Import"
3. Review how the content will look in Confluence
4. Make any necessary adjustments
5. Click "Import" when ready

Media Handling

Images

• Local images are automatically uploaded to Confluence
• Remote images are downloaded and stored in Confluence
• Image references are updated automatically

Attachments

• Files referenced in markdown are uploaded as attachments
• Links to attachments are updated to point to Confluence

Code Blocks

Code blocks are supported with syntax highlighting:

function hello() {
  console.log("Hello, world!");
}

Tables

Markdown tables are converted to Confluence tables:

| Feature | Description                         |
| ------- | ----------------------------------- |
| Tables  | Full table support with alignment   |
| Code    | Syntax highlighting for code blocks |
| Images  | Automatic image upload and linking  |

Task Lists

Convert markdown task lists to Confluence checkboxes:

• [x] Completed task
• [ ] Pending task
• [ ] Another task

Best Practices

1. Backup First: Always backup your Confluence pages before bulk imports
2. Test Small: Test with a small set of files first
3. Check Links: Verify internal links after import
4. Review Media: Ensure all images and attachments are properly imported
5. Update References: Update any external references to the new pages

Troubleshooting

If you encounter any issues:

1. Check the Known Issues page
2. Verify your markdown syntax
3. Ensure all referenced files are accessible
4. Check your Confluence permissions
5. Contact support if needed