diff --git a/content/src/dash.rs b/content/src/dash.rs
index 2a183dff..35ff3fd5 100644
--- a/content/src/dash.rs
+++ b/content/src/dash.rs
@@ -32,10 +32,10 @@ impl<'a> OutlineDash<'a> {
     ///
     /// * `dashes`: The list of dashes, specified as alternating pixel lengths of lines and gaps
     ///   that describe the pattern. See
-    ///   https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setLineDash.
+    ///   <https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/setLineDash>.
     ///
     /// * `offset`: The line dash offset, or "phase". See
-    ///   https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineDashOffset.
+    ///   <https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineDashOffset>.
     #[inline]
     pub fn new(input: &'a Outline, dashes: &'a [f32], offset: f32) -> OutlineDash<'a> {
         OutlineDash { input, output: Outline::new(), state: DashState::new(dashes, offset) }
diff --git a/content/src/fill.rs b/content/src/fill.rs
index f26f302e..18bd1395 100644
--- a/content/src/fill.rs
+++ b/content/src/fill.rs
@@ -16,8 +16,8 @@
 /// rule.
 #[derive(Clone, Copy, PartialEq, Debug)]
 pub enum FillRule {
-    /// The nonzero rule: https://en.wikipedia.org/wiki/Nonzero-rule
+    /// The nonzero rule: <https://en.wikipedia.org/wiki/Nonzero-rule>
     Winding,
-    /// The even-odd rule: https://en.wikipedia.org/wiki/Even%E2%80%93odd_rule
+    /// The even-odd rule: <https://en.wikipedia.org/wiki/Even%E2%80%93odd_rule>
     EvenOdd,
 }
diff --git a/content/src/stroke.rs b/content/src/stroke.rs
index e629d202..8ea20349 100644
--- a/content/src/stroke.rs
+++ b/content/src/stroke.rs
@@ -25,7 +25,13 @@ const TOLERANCE: f32 = 0.01;
 /// 
 /// An example of use:
 /// 
-/// ```norun
+/// ```no_run
+/// use pathfinder_content::stroke::OutlineStrokeToFill;
+/// use pathfinder_content::stroke::StrokeStyle;
+/// use pathfinder_content::outline::Outline;
+///
+/// let input_outline = Outline::new();
+///
 /// let mut stroke_to_fill = OutlineStrokeToFill::new(&input_outline, StrokeStyle::default());
 /// stroke_to_fill.offset();
 /// let output_outline = stroke_to_fill.into_outline();
diff --git a/renderer/src/concurrent/executor.rs b/renderer/src/concurrent/executor.rs
index dc32afa1..3241e725 100644
--- a/renderer/src/concurrent/executor.rs
+++ b/renderer/src/concurrent/executor.rs
@@ -14,7 +14,7 @@
 pub trait Executor {
     /// Like the Rayon snippet:
     ///
-    /// ```norun
+    /// ```ignore
     /// (0..length).into_par_iter().map(builder).collect()
     /// ```
     fn build_vector<T, F>(&self, length: usize, builder: F) -> Vec<T>
diff --git a/renderer/src/concurrent/scene_proxy.rs b/renderer/src/concurrent/scene_proxy.rs
index d0079bd3..611be177 100644
--- a/renderer/src/concurrent/scene_proxy.rs
+++ b/renderer/src/concurrent/scene_proxy.rs
@@ -108,10 +108,9 @@ impl SceneProxy {
     ///
     /// Exactly equivalent to:
     ///
-    /// ```norun
+    /// ```ignore
     /// scene_proxy.build(build_options);
     /// scene_proxy.render(renderer);
-    /// }
     /// ```
     #[inline]
     pub fn build_and_render<D>(&mut self, renderer: &mut Renderer<D>, build_options: BuildOptions)
diff --git a/renderer/src/gpu/debug.rs b/renderer/src/gpu/debug.rs
index 665e8f21..e9f3b5d5 100644
--- a/renderer/src/gpu/debug.rs
+++ b/renderer/src/gpu/debug.rs
@@ -13,7 +13,7 @@
 //! We don't render the demo UI text using Pathfinder itself so that we can use the debug UI to
 //! debug Pathfinder if it's totally busted.
 //!
-//! The debug font atlas was generated using: https://evanw.github.io/font-texture-generator/
+//! The debug font atlas was generated using: <https://evanw.github.io/font-texture-generator/>
 
 use crate::gpu::options::RendererLevel;
 use crate::gpu::perf::{RenderStats, RenderTime};