Skip to content

Markdown's TOC behavior has changed #2342

@waylan

Description

@waylan

With the release of Markdown version 3.3.4 (today), the documentation below is not longer correct:

Note that MkDocs will not generate [anchor links][23] for levels outside
the range defined with `toc_depth`. However, Material for MkDocs also allows

The behavior has been changed in Python-Markdown/markdown#1108 and toc_depth no longer restricts the creation of permalinks. The setting only restricts the creation of the TOC itself.

As an aside, Markdown never documented the old behavior and I didn't even realize that behavior had been introduced. Therefore, I consider the behavior a regression and addressed it as a bug fix.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions