Media Handling Guide

The Markdown Importer for Confluence provides comprehensive support for handling various types of media files during the import process.

Image Handling

Local Images

Local images referenced in your markdown files are automatically:

1. Uploaded to Confluence
2. Stored in the appropriate space
3. Linked correctly in the imported content

Remote Images

Remote images (from URLs) are:

1. Downloaded automatically
2. Uploaded to Confluence
3. Referenced with Confluence URLs

Attachment Management

Supported File Types

The importer handles various attachment types:

• Documents (PDF, DOC, DOCX)
• Images (JPG, PNG, GIF, SVG)
• Archives (ZIP, RAR)
• Code files
• Other binary files

Attachment Processing

During import, attachments are:

1. Uploaded to Confluence
2. Linked correctly in the content
3. Preserved with original metadata

Best Practices

1. Image Optimization: Optimize images before import
2. File Organization: Keep media files in a consistent structure
3. Naming Conventions: Use clear, descriptive names
4. Size Limits: Be aware of Confluence file size limits

Troubleshooting

Common media-related issues:

1. Missing Images: Check file paths and permissions
2. Upload Failures: Verify file size and format
3. Broken Links: Ensure consistent file naming
4. Storage Issues: Monitor Confluence storage limits