Bulk Import Guide

The bulk import feature allows you to import multiple markdown files into Confluence in a single operation, saving you time and effort.

Prerequisites

Before using bulk import, ensure you have:

1. The necessary permissions in Confluence
2. Your markdown files organized in a logical structure
3. All referenced media files accessible

How to Use Bulk Import

Basic Usage

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

Advanced Options

When using bulk import, 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

Best Practices

1. Organize Files: Group related files together before import
2. Check Dependencies: Ensure all referenced files are included
3. Test First: Try with a small subset before bulk import
4. Backup: Always backup your Confluence space before bulk operations

Troubleshooting

Common issues and solutions:

1. Missing Files: Ensure all files are accessible
2. Order Issues: Use consistent naming for proper ordering
3. Media Problems: Check media file permissions
4. Link Breaking: Verify internal links before import