diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8f65706
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# Ciclostile
+
+
+## TODO
+
+- select input and output folders and template by parameters or config file.
+
+
+## Example
+
+Input markdown:
+
+```markdown
+Title: Home Page
+
+# Site
+
+Some text
+```
+
+
+Template:
+
+```html
+
+
+
+ {{ title }}
+
+
+
+{{ content }}
+
+
+
+```
+
+Output html:
+
+```html
+
+
+
+ Home Page
+
+
+
+Site
+Some text
+
+
+
+```