Prerequisites
Before importing, ensure you have:- The necessary permissions in Confluence
- Your markdown files organized in a logical structure
- All referenced media files accessible
How to Import Markdown
Basic Usage
- Navigate to the target Confluence page (for page-level import) or open from the global Apps menu (for global access)
- Click the ••• (More actions) menu and select “Markdown Importer & Exporter”
- Choose single file, multiple files, or upload a
.ziparchive - Click “Import”
Advanced Options
When importing, you can configure:- Import Order: Files are imported in the order they were selected
- Page Hierarchy: Maintain your folder structure as page hierarchy
- Metadata: Import frontmatter as page properties
- Media Handling: Choose how to handle images and attachments
- Target Space: From global access, select one or multiple spaces
- Scope: Admins can import to all spaces in one operation
Best Practices
- Organize Files: Group related files together before import
- Check Dependencies: Ensure all referenced files are included
- Test First: Try with a small subset before large imports
- Backup: Always backup your Confluence space before importing
Troubleshooting
Common issues and solutions:- Missing Files: Ensure all files are accessible
- Order Issues: Use consistent naming for proper ordering
- Media Problems: Check media file permissions
- Link Breaking: Verify internal links before import