`rustdoc` trims all digits except the last two in an ordered list

[zacknewman]

I tried this code:

/// A.
pub enum A {
    /// 123.
    B,
}
/// 123.
pub struct B;

I expected to see this happen: rustdoc src/lib.rs to generate docs with the correct comments.

Instead, this happened: rustdoc src/lib.rs generates documentation trimming 1. Additionally it doesn't generate any summary docs for B in the mod.

Meta

rustc --version --verbose:

rustc 1.97.1 (8bab26f4f 2026-07-14)
binary: rustc
commit-hash: 8bab26f4f68e0e26f0bb7960be334d5b520ea452
commit-date: 2026-07-14
host: x86_64-unknown-linux-gnu
release: 1.97.1
LLVM version: 22.1.6

[zacknewman]

I can supply the actual files under ./doc/ if needed. What gets rendered on the top-level crate HTML looks something like:

Structs

B

Enums

A                 A.

Notice the lack of summary doc next to B unlike A. When on the page for B, it looks like:

pub struct B;

Notice that it shows "23" not "123".

On the page for A, it looks like:

pub enum A {
    B,
}

A.

Variants

B
          23.

Again, notice the comment for variant B says "23" instead of "123".

When a period is removed, the "1" is not trimmed.

[zacknewman]

While I haven't bothered testing all versions of rustdoc, I believe this is a regression introduced in 1.57.0 since the "1" doesn't get trimmed using 1.56.1. I tried a handful more between 1.57.0 and 1.97.1, and all of them trim the "1".

[Urgau]

https://spec.commonmark.org/0.31.2/#ordered-list-marker:

An ordered list marker is a sequence of 1–9 arabic digits (0-9), followed by either a . character or a ) character.

[GuillaumeGomez]

As @Urgau underlined, it's as expected, following the markdown spec. I think there is nothing for us to do here.

[zacknewman]

While this doesn't matter for my specific case since the solution is for me to escape the period, why is rustdoc not displaying the entire value? The HTML does have it as an ordered list with "start" set to the correct value, but the CSS or something else is causing it to not be rendered correctly.

As stated above, 1.56.1 renders it correctly.

Another example:

//! Ordered list starting at 123 per the spec:
//!
//! 123. Apple.
//! 124. Orange.

This should be rendered as:

Ordered list starting at 123 per the spec:

123. Apple.
124. Orange.

But rustdoc, despite generating the correct HTML as something like:

<p>Ordered list starting at 123 per the spec:</p>
<ol start="123">
<li>Apple.</li>
<li>Orange.</li>
</ol>

doesn't actually render the item numbers correctly since it trims all but the last two digits. What gets rendered looks like:

Ordered list starting at 123 per the spec:

23. Apple.
24. Orange.