Skip to content

Rustdoc reports broken-intra-doc-links for Github markdown [!IMPORTANT]-type blockquotes #141866

Open
@Qix-

Description

@Qix-

I tried this code:

#![doc = include_str!("../README.md")]
> [!IMPORTANT]
> This is an important message

I expected to see this happen: Rustdoc at least generating documentation (perhaps not with specialized support for the [!FOO] syntax, but at least not error)

Instead, this happened: With env RUSTFLAGS="-D warnings", rustdoc errored with unresolved link to '!NOTICE'

Meta

rustc --version --verbose:

rustc 1.89.0-nightly (6f6971078 2025-05-28)
binary: rustc
commit-hash: 6f69710780d579b180ab38da4c1384d630f7bd31
commit-date: 2025-05-28
host: x86_64-unknown-linux-gnu
release: 1.89.0-nightly
LLVM version: 20.1.5

rustdoc --version --verbose:

rustdoc 1.89.0-nightly (6f6971078 2025-05-28)
binary: rustdoc
commit-hash: 6f69710780d579b180ab38da4c1384d630f7bd31
commit-date: 2025-05-28
host: x86_64-unknown-linux-gnu
release: 1.89.0-nightly
LLVM version: 20.1.5

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-intra-doc-linksArea: Intra-doc links, the ability to link to items in docs by nameA-lintsArea: Lints (warnings about flaws in source code) such as unused_mut.C-discussionCategory: Discussion or questions that doesn't represent real issues.T-rustdocRelevant to the rustdoc team, which will review and decide on the PR/issue.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions