Mkdocs-material: Disable toc

[nodesocket]

Is there an option to disable Table of contents on all page?

[connerxyz]

@nodesocket did you find a solution to this?

[squidfunk]

Just remove toc from your mkdocs.yml under markdown_extensions.

[connerxyz]

There are currently no extensions listed in my mkdocs.yml file. It _appears_ toc is on by default, which contradicts this:

The following extensions are not enabled by default [...] toc
mkdocs-material/getting-started/#extensions

What am I missing?

[squidfunk]

Oh, that's right. I found this issue on the MkDocs tracker: https://github.com/mkdocs/mkdocs/issues/454. Also see the linked issue.

Currently MkDocs and Python Markdown provide no options to hide the toc, so it's always rendered. You can, however, use CSS to hide it quickly:

.md-sidebar--secondary {
  display: none;
}

[connerxyz]

Okay yeah, I had commented out the toc block from base.html – same result – but I think I like that better.

My underlying issue is that I'd like md-content__inner to expand to fill the right side of the page. This is because there are tables in the markdown that get cutoff. I set md-content--inner to overflow-x: scroll, which is better but not ideal.

Is there a reasonable means of getting the inner content to expand into the toc block space in the render? This is probably simple, but I haven't been able to figure it out. Thanks.

[max-ci]

@connercowling

@media only screen and (min-width: 60em) {
  .md-content {
    margin-right: 0;
  }
}

[connerxyz]

@makshh works great. Much appreciated.

[root-ansh]

@max-ci @connerxyz @squidfunk Hi. I am new to this web designing stuff. Where do we have to add max-ci code (and /or squidfunk's code ?) so as to remove toc and use that space with our center content ? I tried adding in mkdocs.yml but got no success.

[squidfunk]

It's explained in the customization guide.

[nigelwelham]

Is there any way of embedding such code but only in certain .md files - not for every page?
many thanks

[clouddistortion]

Thanks for your nice comments on this topic. After I added the CSS I sometimes saw a flickering with the TOC disappearing after 200ms so I also added a constraint for only rendering heading #1 which is basically like saying don't render anything since the TOC starts at heading #2

markdown_extensions:
    - toc:
        toc_depth : "1-1"

[slavianap]

Thanks for your nice comments on this topic. After I added the CSS I sometimes saw a flickering with the TOC disappearing after 200ms so I also added a constraint for only rendering heading #1 which is basically like saying don't render anything since the TOC starts at heading #2

markdown_extensions:
    - toc:
        toc_depth : "1-1"

Thank you, it works!

[hpcaicom]

@connerxyz I have the same requirement with you, I need add the space for md-content__inner to hold the table. Where did you make the changes on md-content__inner, I add the below into the extra.css, but it doesn't work. And is there a way to make it take effect just on some pages.
@media only screen and (min-width: 60em) {
.md-content {
margin-right: 0;
}
}