Skip to content
This repository has been archived by the owner on Mar 29, 2023. It is now read-only.

markdown TOC renderer should also include at least H4-level items #251

Open
reavertm opened this issue Mar 15, 2022 · 0 comments
Open

markdown TOC renderer should also include at least H4-level items #251

reavertm opened this issue Mar 15, 2022 · 0 comments

Comments

@reavertm
Copy link

reavertm commented Mar 15, 2022

TOC is now explicitly generated from H1, H2 and H3.
However, because of "H1 headers are omitted from the table of contents if there is only one level one header present. This allows H1 to be used as the document title without creating an unnecessary entry in the table of contents.", it makes it effectively two-level TOC only.
Why is that you may ask.

When TOC is used, instead of file name, web page title is assigned from text in first found H1.
Therefore to have cleanly titled pages, it is necessary to have single-H1 .md.
Otherwise, this title entry will "pollute" TOC.
This means, only H2 and H3 can be effectively used for any meaningful TOC.
Which is arguably not enough.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant