You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Masatake Iwasaki (JIRA)" <ji...@apache.org> on 2015/08/12 08:24:46 UTC
[jira] [Commented] (DOXIA-492) Add support for doxia macros in
markdown documents.
[ https://issues.apache.org/jira/browse/DOXIA-492?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14692999#comment-14692999 ]
Masatake Iwasaki commented on DOXIA-492:
----------------------------------------
Because MarkdownParser (which is subclass of XhtmlParser) uses XHTML as intermediate format, it could use macro support of XhtmlParser by DOXIA-529.
> Add support for doxia macros in markdown documents.
> ---------------------------------------------------
>
> Key: DOXIA-492
> URL: https://issues.apache.org/jira/browse/DOXIA-492
> Project: Maven Doxia
> Issue Type: Improvement
> Components: Module - Markdown
> Affects Versions: 1.4
> Reporter: Juergen Kellerer
> Attachments: screen.png
>
>
> 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
> {noformat}
> #`??MACRO_NAME MACRO_ARGS`
> {noformat}
> * Inline
> {noformat}
> `??MACRO_NAME MACRO_ARGS`
> {noformat}
> 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:
> !screen.png!
> 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.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)