Redmine

Redmine MarkItDown Preview¶

This plugin adds attachment previews to Redmine using Microsoft's MarkItDown converter.

The implementation is inspired by the Pandoc preview feature introduced in Redmine 7 and follows the same general approach: attachments are converted into Markdown and rendered through Redmine's standard preview pipeline.

MarkItDown can be used on older Redmine versions that do not provide document previews out of the box and can also be used alongside existing preview solutions by assigning different file extensions.

Features¶

• Markdown-Based Attachment Previews – Attachments are converted to Markdown and rendered using Redmine's standard Markdown preview support
• Microsoft Office Documents – Preview `.docx`, `.xlsx`, and `.pptx` files directly in Redmine
• Outlook Message Support – Preview Outlook `.msg` files
• Legacy Excel Support – Preview older `.xls` files
• Additional Formats – Support for `.csv`, `.epub`, and other MarkItDown compatible formats
• Preview Caching – Generated previews are cached for improved performance
• Configurable Settings – Configure supported extensions, converter command, timeout, and size limits
• Automatic Cleanup – Cached preview files are automatically removed when attachments are deleted
• Older Redmine Versions – Works with Redmine versions that do not include the newer document preview

Notes¶

• The focus is on previewing textual document content
• Embedded images contained in Office documents are currently not included in generated previews
• Original attachments remain unchanged and can still be downloaded normally

Project Information¶

• README
• CHANGELOG
• RELEASE
• SCREENSHOTS

Please see the project README for installation and configuration details.