diff --git a/wgpu-core/src/lib.rs b/wgpu-core/src/lib.rs
index 84922e6b30..e3036ad0f2 100644
--- a/wgpu-core/src/lib.rs
+++ b/wgpu-core/src/lib.rs
@@ -238,8 +238,12 @@ platform supports.";
 ///
 /// Uses of this macro have the form:
 ///
+/// ```ignore
+///
 ///     gfx_select!(id => global.method(args...))
 ///
+/// ```
+///
 /// where `id` is some [`id::Id`] resource id, `global` is a [`hub::Global`],
 /// and `method` is any method on [`Global`] that takes a single generic
 /// parameter that implements [`hal::Api`] (for example,