Change:
//! # The Rust Standard Library //! <del> //! The Rust Standard Library is the foundation of portable Rust //! software, a set of minimal and battle-tested shared abstractions //! for the [broader Rust ecosystem](https://crates.io). It offers //! core types, like [`Vec`](vec/index.html) //! and [`Option`](option/index.html), library-defined [operations on //! language primitives](#primitives), [standard macros](#macros), //! [I/O](io/index.html) and [multithreading](thread/index.html), among //! [many other //! things](#what-is-in-the-standard-library-documentation). //! //! `std` is available to all Rust crates by default, just as if each //! one contained an `extern crate std` import at the [crate //! root][book-crate-root]. Therefore the standard library can be //! accessed in [`use`][book-use] statements through the path `std`, //! as in [`use std::env`](env/index.html), or in expressions //! through the absolute path `::std`, as in //! [`::std::env::args()`](env/fn.args.html). //! //! [book-crate-root]: ../book/crates-and-modules.html#basic-terminology:-crates-and-modules //! [book-use]: ../book/crates-and-modules.html#importing-modules-with-use </del> <ins> //! The Rust Standard Library is the foundation of portable Rust software, a //! set of minimal and battle-tested shared abstractions for the [broader Rust //! ecosystem][crates.io]. It offers core types, like [`Vec<T>`] and //! [`Option<T>`], library-defined [operations on language //! primitives](#primitives), [standard macros](#macros), [I/O] and //! [multithreading], among [many other things][other]. //! //! `std` is available to all Rust crates by default, just as if each one //! contained an `extern crate std;` import at the [crate root]. Therefore the //! standard library can be accessed in [`use`] statements through the path //! `std`, as in [`use std::env`], or in expressions through the absolute path //! `::std`, as in [`::std::env::args()`]. </ins> //! //! # How to read this documentation //! <del> //! If you already know the name of what you are looking for the //! fastest way to find it is to use the <a href="#" //! onclick="focusSearchBar();">search bar</a> at the top of the page. </del> <ins> //! If you already know the name of what you are looking for the fastest way to //! find it is to use the <a href="#" onclick="focusSearchBar();">search //! bar</a> at the top of the page. </ins> //! //! Otherwise, you may want to jump to one of these useful sections: //!

Discussion:
If you're using a reference-style link with a parenthetical statement after it: This will ignore the reference and link to . CommonMark says:
Hoedown does not target CommonMark.
Yeah, this and might both entirely be upstream, but I wanted to 1) make a note to investigate later and 2) have some sort of documentation that things might diverge from expected, for future searchers. :) I would like to switch to something CommonMark compliant, personally.
claims Hoedown actually does target CommonMark.
Triage: no change.
have this an been filed as Hoedown bugs? Worst they could do is say "not our problem". Though, hoedown looks unmaintained.
I don't believe they have, mostly because I would prefer to port rustdoc to pulldown-cmark to eliminate yet another c dependency.
Opened an issue for moving to pulldown-cmark:
Work with so I'm going to go ahead and close.

This might be markdown, it might be rustdoc, it might be both. I haven't determined yet. But links like this don't work: It would seem inside this style of link confuses the parser.
CommonMark says: so at least in theory, this should Just Work.
Triage: no change.
As best as I can tell, these work with so closing.

Part of did a wonderful job here a month or two ago, but we should still double check it, and make sure links are in place for all types, etc.
I am happy with this now.