How to Link to Other Items in Rust Docs with Intra-Doc Links

Use the []() syntax with a relative path to the target item's markdown file or a path to a Rust item within the same crate. For Rust items, use the path relative to the current module, optionally with a # fragment for specific items like methods or fields.

<!-- Link to a chapter file -->
[See Chapter 10](ch10-00-generics.md)

<!-- Link to a Rust item (struct, function, etc.) -->
[The `add` function][add]

<!-- Link to a specific method or field -->
[The `new` method][Vec::new]

<!-- Define the link target if not using auto-linking -->
[add]: ch03-03-how-functions-work.md#how-functions-work

Note: Intra-doc links for Rust code items (like Vec::new) are resolved by rustdoc during the mdbook test or mdbook build process, provided the item is public and visible from the current scope. For markdown file links, ensure the path is relative to the file containing the link.

Intra-doc links let you create clickable references between different parts of your documentation or between your text and your code. Think of them like bookmarks in a book that jump you directly to a specific chapter or definition. You use them to keep your documentation connected and easy to navigate without manually updating URLs when files move.