[DOXIA-492] Add support for doxia macros in markdown documents.

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.4
• Fix Version/s: 1.7
• Component/s: Module - Markdown
• Assignee: Herve Boutemy
• Reporter: Juergen Kellerer
• Created: 19/Jul/13 05:41
• Updated: 08/Sep/17 01:16
• Resolved: 25/Nov/15 00:56

Description

It would be nice if doxia macros could be supported also inside markdown documents (similar to APT).

Existing macros (especially snippet) is very useful, however with the power of maven there's the ability to register own macros for a build process which enables reuse of resources and improves dryness in general.

A syntax which may work could be the following:

• Block Level

   #`??MACRO_NAME MACRO_ARGS`

• Inline

`??MACRO_NAME MACRO_ARGS`

Reference: http://hackage.haskell.org/packages/archive/yesod-markdown/0.0/doc/html/Yesod-Markdown-Macros.html

E.g. using "Texts" it works just from the Editor:

When macros are not interpreted, they fallback to a code block, thus it's easy to edit these sort of documents with one of the existing nice markdown editors.

Issue Links

• depends upon: DOXIA-529 Add macro support to XHTML
• is related to: DOXIA-559 Doxia macro fails with markdown headers past level 4