diff --git a/src/rustdoc/gen.rs b/src/rustdoc/gen.rs
index d0234ad65262..b7997b6d769e 100644
--- a/src/rustdoc/gen.rs
+++ b/src/rustdoc/gen.rs
@@ -81,6 +81,10 @@ fn write_mod_contents(
     write_brief(ctxt, doc.brief);
     write_desc(ctxt, doc.desc);
 
+    for constdoc in *doc.consts {
+        write_const(ctxt, constdoc);
+    }
+
     for fndoc in *doc.fns {
         write_fn(ctxt, fndoc);
     }
@@ -300,6 +304,30 @@ fn should_write_return_description_on_same_line_as_type() {
     assert str::contains(markdown, "Returns `int` - blorp");
 }
 
+fn write_const(
+    ctxt: ctxt,
+    doc: doc::constdoc
+) {
+    write_header(ctxt, h3, #fmt("Const `%s`", doc.name));
+    write_sig(ctxt, doc.ty);
+    write_brief(ctxt, doc.brief);
+    write_desc(ctxt, doc.desc);
+}
+
+#[test]
+fn should_write_const_header() {
+    let markdown = test::render("const a: bool = true;");
+    assert str::contains(markdown, "### Const `a`\n\n");
+}
+
+#[test]
+fn should_write_const_description() {
+    let markdown = test::render(
+        "#[doc(brief = \"a\", desc = \"b\")]\
+         const a: bool = true;");
+    assert str::contains(markdown, "\n\na\n\nb\n\n");
+}
+
 #[cfg(test)]
 mod test {
     fn render(source: str) -> str {