Failed loading extension "toc(permalink=true)"

[zbjornson]

I'm not sure if this is an issue with Markdown or mkdocs.

# with Markdown==3.0.1
> mkdocs build
ERROR   -  Config value: 'markdown_extensions'. Error: Failed loading extension "toc(permalink=true)".

Reverting to Markdown==2.6.11 fixes it.

I'm not sure how to see why it failed to load, which seems like an important bit of info to have before reporting it to Markdown.

[waylan]

Including extension configs in the extension's name was deprecated in Markdown 2.6 (Pending Deprecation in Markdown 2.5). With Markdown 3.0 support has been completely removed.

You should be using MkDocs' documented method for defining extension configs:

markdown_extensions:
    - toc:
        permalink: true

[zbjornson]

Thanks, wasn't aware of the upstream change.