Unable to include handlebar example while using block helper within same doc block

[kidonchu]

I have a doc block that looks like this. This correctly displays the link to Component.MyNewComponent. However, it displays empty content inside of the code block.

/**
 * Modal component
 *
 * This component almost always will be used with
 * {{#crossLink "Component.MyNewComponent"}}{{/crossLink}}.
 *
 * Usage:
 * ```handlebars
 * {{#my-component}}
 * Hello World
 * {{/my-component}}
 * ```
 */

If I apply the advice from #68 with escaping the first curly braces, \{{#my-component}}, then it displays the content of code block correctly. However, it breaks the crossLink helper and doesn't display the link to Component.MyNewComponent. Instead, it displays plain text including {{#crossLink...}}.

Is this happening because I'm doing something wrong? Or are we not supposed to use code block helper and handlebar example within the same doc block?

[markcellus]

I am also having this issue. Any word of advice?

[cristinawithout]

If anybody is still using YUIDoc & has the same issue, I just ran across this using .

It worked to escape both the opening & the closing for the component in the code block. The crossLinks work & the content of the code block shows.

/**
 * Modal component
 *
 * This component almost always will be used with
 * {{#crossLink "Component.MyNewComponent"}}{{/crossLink}}.
 *
 * Usage:
 * ```handlebars
 * \{{#my-component}}
 * Hello World
 * \{{/my-component}}
 * ```
 */