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: mkdocs/mkdocs#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;
}
}

[qmel]

for me

...
# to exclude any headers from table of content and search
'toc' : {
    'baselevel' : 2,
    'toc_depth' : 1
}
...

and

...
'toc' : {
    'toc_depth' : 0
}
...

worked well in 1.4.2 version

[jhshi31]

I think I found a solution. You can manually put this code block in your .md files to prevent the toc from appearing.

---
hide:
  - navigation
  - toc
---

https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#hiding-the-sidebars