diff --git a/Cargo.toml b/Cargo.toml
index 10623b9a..6f110133 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -37,6 +37,7 @@ rand = "0.7.0"
 seahash = "3.0.5"
 serde = "1.0"
 serde_json = "1.0"
+doc-comment = "0.3"
 
 [[bench]]
 name = "header_map"
diff --git a/src/lib.rs b/src/lib.rs
index 98e7b1ed..fc044f2e 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -160,6 +160,13 @@
 
 #![deny(warnings, missing_docs, missing_debug_implementations)]
 
+#[cfg(test)]
+#[macro_use]
+extern crate doc_comment;
+
+#[cfg(test)]
+doctest!("../README.md");
+
 pub mod header;
 pub mod method;
 pub mod request;