Redmine

The Redmine Render Switcher Plugin detects whether each text is written in Textile or Markdown and renders it with the matching formatter.
A site with years of Textile content can let its users write new content in Markdown, without converting a single existing page.

Why This Plugin?¶

Redmine has one site-wide text formatting setting. Switch it from Textile to Markdown and every existing issue,
wiki page and comment written in Textile is suddenly rendered as Markdown: headings turn into plain text, links break,
numbered lists collapse. The usual answer is to bulk-convert the database, which is risky and hard to undo.

This plugin removes the need for that. Existing Textile stays Textile, new Markdown is Markdown, and the two live side by side.
You migrate at the pace your users do, and nothing stored in the database is ever rewritten.

Features¶

• Automatic format detection: Every text field that Redmine renders as wiki text — issue descriptions, comments, wiki pages, news, forum messages, and so on — is rendered with the formatter that matches how it is actually written.
• Non-destructive: Only the rendering changes. Stored text is never modified, and turning the plugin off gives you exactly the behaviour of a Redmine without it.
• Section editing keeps working: Editing a single wiki section behaves the same whichever format the page uses.
• Explicit override: When the detector gets a page wrong, put one line at the top of the body to decide for that page yourself.
• Tunable: Turn detection off site-wide, or adjust how confident the detector must be before it overrides the site setting.
• Cache-safe: The detector version and threshold are part of Redmine's formatted-HTML cache key, so a change to either never serves stale output.
• Small footprint: The plugin patches the two formatter classes only. It registers no new format and adds no database tables, so there are no migrations to run.

cd {REDMINE_ROOT}/plugins/
git clone https://github.com/haru/redmine_render_switcher.git
cd {REDMINE_ROOT}
bundle install

The plugin has no database migrations. Restart Redmine after the installation is complete.