[DOXIA-501] Impossible to use ### header when also using Velocity

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Duplicate
• Affects Version/s: 1.4
• Component/s: Module - Markdown
• Labels: close-pending
• Assignee: Herve Boutemy
• Reporter: Hendrik Schreiber
• Created: 23/Oct/13 04:46
• Updated: 06/Jan/16 19:36
• Resolved: 05/Jan/16 01:21

Description

Markdown and Velocity don't play nicely with each other.

A regular Markdown H3 is usually written like this:

1. 1. 1. My Header

This does not work with Velocity, because ## starts a comment. So, it needs to be escaped like this:

### My Header // DOES NOT WORK

Unfortunately, this does not work, but simply generates "###" in the output, not a level 3 header. For some reason, Markdown does not interpret the "###".

There is a workaround posted on http://mail-archives.apache.org/mod_mbox/maven-users/201303.mbox/[e-mail]%3e — however, that is certainly not satisfying and very awkward.