Files
Albert Krewinkel c954dfab59 Markdown writer: avoid HTML fallbacks in the generated TOC.
The generated table of contents usually has IDs for each TOC link,
allowing to link back to specific parts of the TOC. However, this leads
to unidiomatic markup in formats like gfm, which do not support
attributes on links and hence fall back to HTML. The IDs on TOC items
are now removed in that case, leading to more aesthetic TOCs.

Closes: #8131
2022-12-20 18:21:16 +01:00

42 lines
663 B
Markdown

# TOC in gfm contains no HTML by default
```
% pandoc --to=gfm --toc --standalone
# Head
Content
^D
- [Head](#head)
# Head
Content
```
# Same in Markdown if link_attributes extension is disabled
```
% pandoc --to=markdown-link_attributes --toc --standalone
# Head
Content
^D
- [Head](#head)
# Head
Content
```
# IDs are added to TOC with the "attributes" CommonMark extension
```
% pandoc --to=commonmark+gfm_auto_identifiers+attributes --toc -s
# Nam a sapien
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
^D
- [Nam a sapien](#nam-a-sapien){#toc-nam-a-sapien}
# Nam a sapien
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
```