RS.CLIPPY.DOC_NESTED_REFDEFS

Link reference defined in list item or quote

This checker is a Clippy lint created by The Rust Project Contributors. The documentation shown here is a copy of the original documentation for: doc_nested_refdefs. Copyright ©2025 The Rust Team. All rights reserved.

What it does

Warns if a link reference definition appears at the start of a list item or quote.

Why is this bad?

This is probably intended as an intra-doc link. If it is really supposed to be a reference definition, it can be written outside of the list item or quote.

Example

//! - [link]: description

Use instead:

//! - [link][]: description (for intra-doc link)
//!
//! [link]: destination (for link reference definition)