diff --git a/README.md b/README.md
new file mode 100644
index 0000000..09208ca
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+Curriculum vitae
+================
+
+Curriculum vitae template that uses LaTeX for rendering, via Pandoc. If
+you want to adapt it to your needs:
+
+  ---------------------| ---------
+  Sections and layout  | Details
+  *.latex              | *.yml
+  ---------------------| ---------
+
+Requirements
+------------
+
+-   Pandoc
+-   GNU Make
+-   LaTeX (only tested with TeX Live)
+
+Usage
+-----
+
+Compile the documents using make
+
+```shell
+make
+```
+
+shell
+
+The pdf documents will appear in the same folder.