kwin opened a new issue, #1015:
URL: https://github.com/apache/maven-doxia/issues/1015
### Affected version
2.0.0
### Bug description
Currently these Sink events are not properly handled by the MarkdownSink:
```
sink.definitionList();
sink.definedTerm();
sink.text("question1");
sink.definedTerm_();
sink.definition();
sink.link("#top");
sink.text("[top]");
sink.link_();
sink.definition_();
sink.definitionList_();
```
This leads to the incorrect Markdown
```
<dl>
<dt>question1</dt>
<dd>[[top]](#top)</dd>
</dl>
```
The link must be either emitted as `<a>` tag or the surrounding HTML block
of `<dd>` must be closed with an empty line.
https://daringfireball.net/projects/markdown/syntax#html states that
> Note that Markdown formatting syntax is not processed within block-level
HTML tags.
and
> Unlike block-level HTML tags, Markdown syntax is processed within
span-level tags.
In https://spec.commonmark.org/0.31.2/#html-blocks it is similar
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
