Repository navigation
Admonition Fatigue #41
Description
Just a bit of friendly feedback, I find the admonition use in the book a bit challenging to read.
I've heard the idea of 'admonition fatigue' passed around, to me an admonish reads a bit like SHOUTING. WHEN EVERYTHING IS CAPITAL LETTERS IT GETS NOISY, ESPECIALLY WHEN THE CONTENT IS VERY LONG OR JUST A LINK OR SOMETHING THAT DOES NOT REQUIRE EMPHASIS (im not actually shouting here 🙃)
Love the idea of spicing mdbook up with color, it has great theming support, could be a oneshot prompt to replace the admonishments with something more legible but equally pretty.
Just my personal experience, thanks for the awesome library!
Activity
schungx commentedon Mar 11, 2026
True. With the new version of
mdbookthe admonish plugin so far does not support it. So it prevents the book from upgrading to the latest version.I have been thinking of removing the admonitons but since they are too prevalent and I don't have the time to do it. And I haven't thought about what to replace them with.
Any suggestions?
mrchantey commentedon Mar 12, 2026
Interesting I'll have a closer look when I get a chance.