n0guest/redmine_convert_textile_to_markown

Redmine rake task to convert content from textile to markdown

Redmine converter from Textile to Markown

This is a rake task for Redmine that uses pandoc to convert database content from Textile to Markdown formatting. The conversion is tweaked to adapt to Redmine's special features.

Known limitations

Because Redmine's textile is different than pandoc's textile, and because of some limitation in pandoc, the result will not be perfect, but it should be good enough to get you started. Here are some known limitations:

• Numbered lists containing <pre> blocks will lose their numbering (restarting at 1 after the <pre>). Some complex cases will lose their list layout entirely.
• Tables without proper headers will be rendered with an empty header
• Some interlaced formatting of inline code and bold will be messed up
• <!-- --> may appear in final ouput in a few places because Redmine incorrectly does not support HTML in markdown

Usage

1. Backup your database

2. Install pandoc

3. Install the task:

   cd $REDMINE_ROOT_DIRECTORY
   wget -P lib/tasks/ https://github.com/Ecodev/redmine_convert_textile_to_markown/raw/master/convert_textile_to_markdown.rake

4. Run the task:

   bundle exec rake convert_textile_to_markdown RAILS_ENV=production

History

This script was built upon @sigmike answer on Stack Overflow, later slightly modified by Hugues C. and finally significantly completed by us.