diff --git a/README b/README
deleted file mode 100644
index 7e0b49e..0000000
--- a/README
+++ /dev/null
@@ -1,5 +0,0 @@
-These are lxc bindings for python2.
-
-Build:      python setup.py build
-Install:    python setup.py install
-Build rpm:  python setup.py bdist_rpm
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..dafa3db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# python2-lxc
+
+This repository provides python2 bindings for the [LXC](https://github.com/lxc/lxc)
+container API.
+
+# Build
+
+- Build:
+  ```
+  python setup.py build
+  ```
+- Install:
+  ```
+  python setup.py install
+  ```
+- Build rpm:
+  ```
+  python setup.py bdist_rpm
+  ```