Skip to content

Option to opt out of the skip-to-content link #14686

Description

@cscheid

#14684 (implemented in #14685) added an always-on "Skip to main content" link to Bootstrap-themed HTML output (first element of <body>, visually hidden until focused). This matches MkDocs Material and pkgdown, which also ship it unconditionally, and the link text is already customizable via the language key skip-to-content.

Some users may still want to suppress it — e.g. sites that hand-roll their own skip link in a custom layout or via include-before-body (the workaround discussed in #11602), which now results in two skip links (the built-in one is always the first tab stop; a hand-rolled one remains functional but redundant).

This issue tracks adding an opt-out (e.g. skip-link: false under the html format or website config) if there is demand.

Deliberately deferred from #14684/#14685 to keep the initial change zero-config.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    accessibilityenhancementNew feature or requesthtmlIssues with HTML and related web technology (html/css/scss/js)

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions