[
https://issues.apache.org/jira/browse/MSITE-728?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15065827#comment-15065827
]
Hervé Boutemy edited comment on MSITE-728 at 12/20/15 5:25 PM:
---------------------------------------------------------------
in Velocity, {{# header 1}} has no meaning (since Velocity expects no space
after {{#}}), but {{## header 2}} has a meaning in Velocity: it's a comment
line (see [Velocity documentation about
comments|http://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html#Comments])
then you have to use Velocity escape sequence to avoid Velocity interpretation
then let Markdown do its job:
{code}$esc.h# Headline 2{code}
was (Author: hboutemy):
in Velocity, {{# header 1}} has no meaning (since Velocity expects no space
after {{#}}, but {{## header 2}} has a meaning in Velocity: it's a comment line
(see [Velocity documentation about
comments|http://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html#Comments])
then you have to use Velocity escape sequence to avoid Velocity interpretation
then let Markdown do its job:
{code}$esc.h# Headline 2{code}
> Markdown headings (atx-style) not rendered correctly with Velocity Macro
> ------------------------------------------------------------------------
>
> Key: MSITE-728
> URL: https://issues.apache.org/jira/browse/MSITE-728
> Project: Maven Site Plugin
> Issue Type: Bug
> Components: doxia integration
> Affects Versions: 3.4
> Environment: $ mvn -version
> Apache Maven 3.2.3 (33f8c3e1027c3ddde99d3cdebad2656a31e8fdf4;
> 2014-08-11T22:58:10+02:00)
> Maven home: /usr/local/Cellar/maven/3.2.3/libexec
> Java version: 1.7.0_60, vendor: Oracle Corporation
> Java home: /Library/Java/JavaVirtualMachines/jdk1.7.0_60.jdk/Contents/Home/jre
> Default locale: en_US, platform encoding: UTF-8
> OS name: "mac os x", version: "10.9.4", arch: "x86_64", family: "mac"
> Reporter: Ingmar Steiner
> Assignee: Hervé Boutemy
> Priority: Minor
> Fix For: 3.5
>
>
> Markdown files with atx-style headings are rendered correctly by `mvn site`,
> but if they have a `.vm` suffix (i.e., to trigger property expansion), then
> some of the headings are missing in the HTML output.
> I've created a minimal non-working example test project at
> https://github.com/psibre/mnwe-md-vm-headings. This includes the generated
> site output as a `gh-pages` branch, hosting it at
> http://psibre.github.io/mnwe-md-vm-headings/.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
