docs
docs copied to clipboard
Incorporate in Markdown docs also possibility to reuse
Description
Maybe mention in the Markdown docs: https://www.dita-ot.org/dev/reference/markdown/markdown-dita-syntax that you can also conref content from a DITA topic like:
<p data-conref="t1.dita#t1/reused"/>
There's been some discussion of this in the past, and while it works, I recall there was some hesitation to recommending XML-in-Markdown for things like this.
When authoring HTML in Markdown, that's the official fallback:
For any markup that is not covered by Markdown’s syntax, you simply use HTML itself.
In LwDITA, things like this work in some cases, but I'm not sure the spec really intended for things to be done this way. The Markdown DITA format supports a few things LwDITA doesn't, but we'd need to be very clear on what works where.
Perhaps @jelovirt, @fwegmann, or others can provide additional details.
When I looked at the LwDITA plugin's test content a while ago, I saw some aspects that didn't appear to be documented. Perhaps it was just the conref mentioned by @raducoravu, but I'd recommend a scan through the test content directories and the file contents themselves for a thorough sweep if we want a comprehensive list.