You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository has been archived by the owner on Mar 29, 2023. It is now read-only.
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.
The text was updated successfully, but these errors were encountered:
Sign up for freeto subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
The text was updated successfully, but these errors were encountered: