Open alexeyzimarev opened 2 months ago
These appear to be the same issues reported in #9719.
However, opening angle brackets aren't escaped, which causes some static site generators to fail as they expect an HTML tag when processing opening angle brackets.
Currently markdown
output format is intended to be used as input for docfx build
command.
And following problems are known other than #9719
when markdown files are used by other tools.
<xref>
tag is rendered to markdown files. (#9879)<a>
tag for anchor at headings (#9720)
Describe the bug When using
docfx metadata
to generate Markdown output, most of the Markdown-supported characters are properly escaped with\
. However, opening angle brackets aren't escaped, which causes some static site generators to fail as they expect an HTML tag when processing opening angle brackets.To Reproduce Use a config file similar to this, with
outputFormat
set tomarkdown
:Run
docfx metadata
. Inspect Markdown output.Notice that opening angle brackets aren't escaped, whilst closing angle brackets are:
Expected behavior
Output like this:
Context: