Can you add exclude a header from toc in secondary sidebar?

[ngtrian]

Description

Can you add exclude a header from toc in secondary sidebar? I want add a header 5 to content, but I don't want display header 5 in secondary sidebar (md-sidebar md-sidebar--secondary)

Package versions

• Python: 2.7.12
• MkDocs: 0.16.3
• Material: 1.6.1

[facelessuser]

I believe something like this could help: #136, but you'd have to adjust the CSS to target your desired level.

[ngtrian]

This can not solve my problem. I want to hide heading 5 not level 2 in toc

Because I want to use headings in documents in a certain file, But I do not want them to appear in TOC.

[facelessuser]

That isn't what #136 means. The person wanted to hide anything greater than 2 levels deep (this isn't referring to h1). So they wanted to show h2 and h3, so the solution hides h4+. If I understand correctly, you want to hide h5+, so you would need to tweak the CSS to start hiding 1 level deeper.

Unless I am still misunderstanding.

[ngtrian]

Simple I want to use a heading (h5) in documents in a certain file, But I do not want them to appear in TOC.
Here I use heading 5 less used to avoid overlapping with the heading of other markdown files

[facelessuser]

At most, all that can be done is excluding a certain header level with CSS. So the solution above is based on header levels (forth in the nested hierarchy), but not header type (h5). The TOC generator (which is separate from this theme), does not have the ability to exclude a specific header type. And the TOC in the sidebar does not track the header type, but simply nests them in a logical hierarchy.

So targeting specifically h5 in the sidebar TOC (with the purpose of hiding it) is not possible, but targeting the 4th level nesting is possible.

label[for="toc"]+.md-nav__list .md-nav__list .md-nav__list .md-nav__list {
    display: none;
}

But if you skipped nesting levels, for example nest h5 directly under h2, then this would not hide h5 as it would not be at the proper nested level. So if this is not sufficient for you, I don't think what you want is possible

[squidfunk]

When you specify your heading in the Markdown file not like this:

##### Heading

but like this:

<h5>Heading</h5>

It will render correctly and won't appear in the table of contents.

[ngtrian]

thank a tip of @squidfunk .

[facelessuser]

Never realized this was built-in to the current TOC plugin. Nice to know!

[squidfunk]

Well, technically it isn't. The TOC plugin is only parsing the Markdown headline definitions, so by using HTML tags, you sneak them past the TOC plugin unoticed, as it doesn't parse the HTML. Closing this, as it seems to be solved. Otherwise please re-open.

[chrimaho]

Hi @squidfunk , is this still the case? It seems like now the TOC is able to render headings which are parsed using HTML tags. Is there any other way in which we can exclude any header from being added to the TOC?

Thank you.

[squidfunk]

The fix mentioned in #313 (comment) should still work, and it should be unaffected by the new built-in typeset plugin. If that's not the case, please open a new bug report.