diff --git a/.gitignore b/.gitignore
index af83fd5ca..4046e40f0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,6 @@
 .DS_Store
+
 *.py[co]
+
+docs/index.md
+site/
diff --git a/Makefile b/Makefile
new file mode 100644
index 000000000..1019b53b8
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,12 @@
+BASEDIR=$(CURDIR)
+DOCDIR=$(BASEDIR)/docs
+
+install:
+	pip install mkdocs
+
+preview:
+	mkdocs serve
+
+deploy:
+	ln -sf $(BASEDIR)/README.md $(DOCDIR)/index.md
+	mkdocs gh-deploy --clean
diff --git a/docs/CNAME b/docs/CNAME
new file mode 100644
index 000000000..0f6ced663
--- /dev/null
+++ b/docs/CNAME
@@ -0,0 +1 @@
+awesome-python.com
\ No newline at end of file
diff --git a/docs/extra.css b/docs/extra.css
new file mode 100644
index 000000000..2f58f224a
--- /dev/null
+++ b/docs/extra.css
@@ -0,0 +1,37 @@
+.bs-sidebar.well {
+    /* margin-bottom: 0; */
+}
+
+.bs-sidebar .nav > li > a:hover,
+.bs-sidebar .nav > li > a:focus {
+    border: none;
+    border-left: 2px solid;
+}
+
+.bs-sidebar .nav > .active > a,
+.bs-sidebar .nav > .active:hover > a,
+.bs-sidebar .nav > .active:focus > a {
+    border: none;
+    border-left: 2px solid;
+}
+
+@media (min-width: 992px) {
+    .bs-sidebar.affix {
+        /* top: 60px; */
+        /* bottom: 0px; */
+        top: 80px;
+        bottom: 23px;
+        overflow: auto;
+    }
+}
+
+@media (min-width: 1200px) {
+    .bs-sidebar.affix-bottom,
+    .bs-sidebar.affix {
+        width: 280px;
+    }
+
+    .container > .col-md-9 {
+        padding-left: 40px;
+    }
+}
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 000000000..24f5548dc
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,6 @@
+site_name: Awesome Python
+site_url: http://awesome-python.com
+site_description: "A curated list of awesome Python frameworks, libraries and software"
+site_author: Vinta Chen
+repo_url: https://github.com/vinta/awesome-python
+theme: flatly