MD -> DITA: Escaped '[]' not ignored
Posted: Thu Aug 20, 2020 3:00 pm
Hi there,
I use XML Author 21.1 to convert markdown to DITA (File -> Open -> [Open MD File]).
Works well, but I came across a problem with brackets '[]'. We usually use them to indicate that readers need to put in there specific value in a path. To avoid that these are interpreted as link or reference in markdown, I escaped them, like in the following example:
Conversion result:
In my opinion, the slashes in '\[YOUR-CLUSTER\] should be omitted in the conversion result. I also tried using just one escaping backslash (for the first bracket), but then that one is part of the conversion result.
If I leave them both out, the conversion parses a markdown link (which I don't want either):
Is there any way to get around this? A special escape character I may not know? Or is this a bug?
Thank you,
Jens
I use XML Author 21.1 to convert markdown to DITA (File -> Open -> [Open MD File]).
Works well, but I came across a problem with brackets '[]'. We usually use them to indicate that readers need to put in there specific value in a path. To avoid that these are interpreted as link or reference in markdown, I escaped them, like in the following example:
Code: Select all
Choose *CLUSTERS* > *\[YOUR-CLUSTER\]* > *OVERVIEW* > *Lifecycle* > *Maintenance*.
Code: Select all
Choose
<i>CLUSTERS</i> > <i>\[YOUR-CLUSTER\]</i> > <i>OVERVIEW</i> > <i>Lifecycle</i> > <i>Maintenance</i>.
If I leave them both out, the conversion parses a markdown link (which I don't want either):
Code: Select all
Choose
<i>CLUSTERS</i> > <i><xref keyref="YOUR-CLUSTER"/></i> > <i>OVERVIEW</i> > <i>Lifecycle</i> > <i>Maintenance</i>
Thank you,
Jens