diff --git a/README.md b/README.md
deleted file mode 100644
index 07992e5..0000000
--- a/README.md
+++ /dev/null
@@ -1,61 +0,0 @@
-django-queryset-csv
-===================
-[![Build Status](https://travis-ci.org/azavea/django-queryset-csv.png)](https://travis-ci.org/azavea/django-queryset-csv)
-[![Coverage Status](https://coveralls.io/repos/azavea/django-queryset-csv/badge.png)](https://coveralls.io/r/azavea/django-queryset-csv)
-[![Version](https://pypip.in/v/django-queryset-csv/badge.png)](http://pypi.python.org/pypi/django-queryset-csv/)
-[![Downloads](https://pypip.in/d/django-queryset-csv/badge.png)](http://pypi.python.org/pypi/django-queryset-csv/)
-[![License](https://pypip.in/license/django-queryset-csv/badge.png)](http://www.gnu.org/licenses/gpl.html)
-
-
-a CSV exporter for django querysets.
-
-This tool was created out of repeatedly needing to do the following in django:
-
-1. write CSV data that is based on simple querysets.
-2. automatically encode unicode characters to utf-8
-3. create a shortcut to render a queryset to a CSV HTTP response
-4. add a time/datestamping mechanism to CSV filenames
-
-## usage
-Perform all filtering and field authorization in your view using `.filter()` and `.values()`.
-Then, use `render_to_csv_response` to turn a queryset into a respone with a CSV attachment.
-Pass it a `QuerySet` or `ValuesQuerySet` instance.
-
-```python
-from djqscsv import render_to_csv_response
-
-def csv_view(request):
-  qs = Foo.objects.filter(bar=True).values('id', 'bar')
-  return render_to_csv_response(qs)
-```
-
-## foreign keys
-
-Foreign keys are supported natively using `ValuesQuerySet` in Django. Simply use the `__` technique as 
-you would in the Django ORM when you pass args to the `.values()` method.
-
-in models.py:
-
-```python
-from django.db import models
-
-class Food(models.Model):
-    name = models.CharField(max_length=20)
-
-class Person(models.Model):
-    name = models.CharField(max_length=20)
-    favorite_food = models.ForeignKey(Food)
-
-```
-in views.py:
-```python
-from djqscsv import render_to_csv_response
-
-def csv_view(request):
-    people = Person.objects.values('name', 'favorite_food__name')
-    return render_to_csv_response(people)
-```
-
-## todo
-
-Planned development items are logged on the github issues page.
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..cd29490
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,60 @@
+.. image:: https://travis-ci.org/azavea/django-queryset-csv.png
+   :target: https://travis-ci.org/azavea/django-queryset-csv
+
+.. image:: https://coveralls.io/repos/azavea/django-queryset-csv/badge.png
+   :target: https://coveralls.io/r/azavea/django-queryset-csv
+
+.. image:: https://pypip.in/v/django-queryset-csv/badge.png
+   :target: http://pypi.python.org/pypi/django-queryset-csv/
+
+.. image:: https://pypip.in/d/django-queryset-csv/badge.png
+   :target: http://pypi.python.org/pypi/django-queryset-csv/
+
+.. image:: https://pypip.in/license/django-queryset-csv/badge.png
+   :target: http://www.gnu.org/licenses/gpl.html
+
+a CSV exporter for django querysets.
+
+This tool was created out of repeatedly needing to do the following in django:
+
+1. write CSV data that is based on simple querysets.
+2. automatically encode unicode characters to utf-8
+3. create a shortcut to render a queryset to a CSV HTTP response
+4. add a time/datestamping mechanism to CSV filenames
+
+usage
+-----
+Perform all filtering and field authorization in your view using ``.filter()`` and ``.values()``.
+Then, use ``render_to_csv_response`` to turn a queryset into a respone with a CSV attachment.
+Pass it a ``QuerySet`` or ``ValuesQuerySet`` instance::
+
+  from djqscsv import render_to_csv_response
+
+  def csv_view(request):
+    qs = Foo.objects.filter(bar=True).values('id', 'bar')
+    return render_to_csv_response(qs)
+
+foreign keys
+------------
+
+Foreign keys are supported natively using ``ValuesQuerySet`` in Django. Simply use the ``__`` technique as 
+you would in the Django ORM when you pass args to the ``.values()`` method.
+
+models.py::
+
+  from django.db import models
+
+  class Food(models.Model):
+      name = models.CharField(max_length=20)
+
+  class Person(models.Model):
+      name = models.CharField(max_length=20)
+      favorite_food = models.ForeignKey(Food)
+
+views.py::
+
+  from djqscsv import render_to_csv_response
+
+  def csv_view(request):
+      people = Person.objects.values('name', 'favorite_food__name')
+      return render_to_csv_response(people)
diff --git a/setup.py b/setup.py
index e226881..cbef010 100644
--- a/setup.py
+++ b/setup.py
@@ -5,9 +5,9 @@
 
 setup(
     name='django-queryset-csv',
-    version='0.2.4',
+    version='0.2.5',
     description='A simple python module for writing querysets to csv',
-    long_description=open('README.md').read(),
+    long_description=open('README.rst').read(),
     author=author,
     author_email=author_email,
     maintainer=author,