Repository navigation
Rustdoc: table stripes hide inline code span background color #159234
Description
Code
I ran into this in Bevy, tho the effect is noticeable in any rustdoc docs which uses a table containing inline code spans.
/// | Examples | Explanation |
/// | --------------------------------- | ------------------------------ |
/// | `CompA` | A unit or default component... |
/// | `CompA(val)`<br>`CompA(val, val)` | Tuple Component with some... |
Reproduction Steps
- Write a doc comment with a table which has an inline code span
like thisi the second row - generate rustdoc
- view with dark or ayu themes
- notice how inline code span background disappears into alternating table color
Expected Outcome
Inline code spans background to stand out inside tables, making it easy to understand whats supposed to be code and what text.
Actual Output
Example here: https://docs.rs/bevy_scene/latest/bevy_scene/macro.bsn.html
Screencast_20260713_173318.webm
Its especially bad on the non-ayu dark theme, where the text color for inline spans is white as well, which means the only factor to distinguish inline code from text is the monospace font.
Version
rustdoc 1.98.0-nightly (57d0690 2026-05-27)
But the css still exists on main as of posting this.
Additional Details
Introduced by #105486 best i can tell
Activity
kantnero commentedon Jul 16, 2026
Confirmed this doesn't reproduce on stable (1.97.0). I'll look into what change is causing this.
@rustbot claim
kantnero commentedon Jul 16, 2026
Looking at the issue again this seems to be the default behavior since #105442 and is reproducible in all rust version.
Before #105442 all table rows shared one background color, and inline code spans had a slightly different background, making them visually distinct. After #105442, table rows now alternate between two background colors, and one of those two stripe colors happens to match the existing inline-code background color exactly so on that row, the code span becomes invisible against the background. On the other stripe color, it's still visible.
Before:
After
Rollup merge of rust-lang#160438 - GuillaumeGomez:table-odd-code, r=n…
Rollup merge of rust-lang#160438 - GuillaumeGomez:table-odd-code, r=n…
Unrolled build for #160438