I'm using the Markdown Doxia plugin to author my site documentation in Markdown.
The particular page of content I'm using has a .vm suffix on it because I also filter in Maven pom properties. This combination of things turns out to need escaping all over the place. For example, one way of doing second-level headers in Markdown is to prefix the text with two hash signs (##). This apparently does something comment-ish with Velocity. Or linking an API reference like this: [some reference](path/to/javadoc/SomeClass.html#someMethod(String)) The parentheses around the method arguments silently disappear, probably due to the anchor. Various attempts with backslashes in front of the hash signs doesn't help. Other sites have suggested that perhaps setting variables Velocity style would work, but they don't. So: with this particular combination of technologies, how can I escape Velocity-meaningful tokens that are still nevertheless processed unmolested by Markdown? Best, Laird -- http://about.me/lairdnelson
