diff --git a/README.md b/README.md
new file mode 100644
index 0000000..68394f1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,72 @@
+# Pydantic Mongo
+
+[![Build Status](https://github.com/jefersondaniel/pydantic-mongo/actions/workflows/test.yml/badge.svg)](https://github.com/jefersondaniel/pydantic-mongo/actions) [![Maintainability](https://api.codeclimate.com/v1/badges/5c92ea54aefa29f919cf/maintainability)](https://codeclimate.com/github/jefersondaniel/pydantic-mongo/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/5c92ea54aefa29f919cf/test_coverage)](https://codeclimate.com/github/jefersondaniel/pydantic-mongo/test_coverage) [![Version](https://badge.fury.io/py/pydantic-mongo.svg)](https://pypi.python.org/pypi/pydantic-mongo) [![Downloads](https://img.shields.io/pypi/dm/pydantic-mongo.svg)](https://pypi.python.org/pypi/pydantic-mongo)
+
+Document object mapper for pydantic and pymongo
+
+## Usage
+
+### Install:
+
+```bash
+pip install pydantic-mongo
+```
+
+### Example Code
+
+```python
+from pydantic import BaseModel
+from pydantic_mongo import AbstractRepository, ObjectIdField
+from pymongo import MongoClient
+from bson import ObjectId
+
+class Foo(BaseModel):
+   count: int
+   size: float = None
+
+class Bar(BaseModel):
+   apple = 'x'
+   banana = 'y'
+
+class Spam(BaseModel):
+   id: ObjectIdField = None
+   foo: Foo
+   bars: List[Bar]
+
+class SpamRepository(AbstractRepository[Spam]):
+   class Meta:
+      collection_name = 'spams'
+
+client = MongoClient(os.environ["MONGODB_URL"])
+database = client[os.environ["MONGODB_DATABASE"]]
+
+spam = Spam(foo=Foo(count=1, size=1.0),bars=[Bar()])
+
+spam_repository = SpamRepository(database=database)
+
+# Insert / Update
+spam_repository.save(spam)
+
+# Insert / Update many items
+spam_repository.save_many([spam])
+
+# Delete
+spam_repository.delete(spam)
+
+# Find One By Id
+result = spam_repository.find_one_by_id(spam.id)
+
+# Find One By Id using string if the id attribute is a ObjectIdField
+result = spam_repository.find_one_by_id(ObjectId('611827f2878b88b49ebb69fc'))
+
+# Find One By Query
+result = spam_repository.find_one_by({'foo.count': 1})
+
+# Find By Query
+results = spam_repository.find_by({'foo.count': {'$gte': 1}})
+
+# Paginate using cursor based pagination
+edges = spam_repository.paginate({'foo.count': {'$gte': 1}}, limit=1)
+more_edges = spam_repository.paginate({'foo.count': {'$gte': 1}}, limit=1, after=edges[-1].cursor)
+last_model = more_edges[-1].node
+```
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 943324b..0000000
--- a/README.rst
+++ /dev/null
@@ -1,94 +0,0 @@
-Pydantic Mongo
-======================================
-
-|Build Status| |Maintainability| |Test Coverage| |Version| |Downloads|
-
-Document object mapper for pydantic and pymongo
-
-Documentation
-~~~~~~~~~~~~~
-
-Usage
-^^^^^
-
-Install:
-''''''''
-
-.. code:: bash
-
-   $ pip install pydantic-mongo
-
-''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
-
-.. code:: python
-
-    from pydantic import BaseModel
-    from pydantic_mongo import AbstractRepository, ObjectIdField
-    from pymongo import MongoClient
-    from bson import ObjectId
-
-    class Foo(BaseModel):
-        count: int
-        size: float = None
-
-    class Bar(BaseModel):
-        apple = 'x'
-        banana = 'y'
-
-    class Spam(BaseModel):
-        id: ObjectIdField = None
-        foo: Foo
-        bars: List[Bar]
-
-    class SpamRepository(AbstractRepository[Spam]):
-        class Meta:
-            collection_name = 'spams'
-
-    client = MongoClient(os.environ["MONGODB_URL"])
-    database = client[os.environ["MONGODB_DATABASE"]]
-
-    spam = Spam(foo=Foo(count=1, size=1.0),bars=[Bar()])
-
-    spam_repository = SpamRepository(database=database)
-
-    # Insert / Update
-    spam_repository.save(spam)
-
-    # Insert / Update many items
-   spam_repository.save_many([spam])
-
-    # Delete
-    spam_repository.delete(spam)
-
-    # Find One By Id
-    result = spam_repository.find_one_by_id(spam.id)
-
-    # Find One By Id using string if the id attribute is a ObjectIdField
-    result = spam_repository.find_one_by_id(ObjectId('611827f2878b88b49ebb69fc'))
-
-    # Find One By Query
-    result = spam_repository.find_one_by({'foo.count': 1})
-
-    # Find By Query
-    results = spam_repository.find_by({'foo.count': {'$gte': 1}})
-
-    # Paginate using cursor based pagination
-    edges = spam_repository.paginate({'foo.count': {'$gte': 1}}, limit=1)
-    more_edges = spam_repository.paginate({'foo.count': {'$gte': 1}}, limit=1, after=edges[-1].cursor)
-    last_model = more_edges[-1].node
-''''
-
-.. |Build Status| image:: https://github.com/jefersondaniel/pydantic-mongo/actions/workflows/test.yml/badge.svg
-   :target: https://github.com/jefersondaniel/pydantic-mongo/actions
-
-.. |Maintainability| image:: https://api.codeclimate.com/v1/badges/5c92ea54aefa29f919cf/maintainability
-   :target: https://codeclimate.com/github/jefersondaniel/pydantic-mongo/maintainability
-
-.. |Test Coverage| image:: https://api.codeclimate.com/v1/badges/5c92ea54aefa29f919cf/test_coverage
-   :target: https://codeclimate.com/github/jefersondaniel/pydantic-mongo/test_coverage
-
-.. |Version| image:: https://badge.fury.io/py/pydantic-mongo.svg
-   :target: https://pypi.python.org/pypi/pydantic-mongo
-
-.. |Downloads| image:: https://img.shields.io/pypi/dm/pydantic-mongo.svg
-   :target: https://pypi.python.org/pypi/pydantic-mongo
diff --git a/setup.py b/setup.py
index b5d0953..f8eac08 100644
--- a/setup.py
+++ b/setup.py
@@ -2,7 +2,7 @@
 
 from setuptools import setup
 
-long_description = open("README.rst", "r").read()
+long_description = open("README.md", "r").read()
 
 package_root = os.path.abspath(os.path.dirname(__file__))
 
@@ -22,6 +22,7 @@
     },
     description="Document object mapper for pydantic and pymongo",
     long_description=long_description,
+    long_description_content_type="text/markdown",
     url="https://github.com/jefersondaniel/pydantic-mongo",
     author="Jeferson Daniel",
     author_email="jeferson.daniel412@gmail.com",