mdbook 0.5.x now ships admonitions: https://rust-lang.github.io/mdBook/format/markdown.html#admonitions Once we upgrade to 0.5.x (#641) we can drop the custom code for admonitions and use the build it ones.