diff --git a/README b/README
index 472b0c1..61ead1f 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-tepal is a Template Parsing Library, written in C.
+tepal is a Template Parsing Library, written in C.
It's origin lies in my unhappieness with PHP, JSP and other
languages designed for web-development. Lately i learned a little
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5fb8395
--- /dev/null
+++ b/README.md
@@ -0,0 +1,59 @@
+# tepal
+
+Tepal is a Template Parsing Library, written in C.
+
+## Synopsis
+
+[unknown]
+
+## Description
+
+It's origin lies in my unhappieness with PHP, JSP and other
+languages designed for web-development. Lately i learned a little
+about template system and worked a little with smarty and after a
+while i got the idea that if one wants to seperate program logic
+from display logic it is also possible to write you application
+in C as i prefer. The FastCGI interface is as fast or even faster than
+the PHP interface. The only thing needed is a library that does the
+same things as smarty, set template variables, parse a template and
+write the result.
+
+Well, it turns out that this only thing was more work than i first
+thought, especially because i never wrote an interpreter or compiler
+before. And i had not college courses on that issue too. So i had to
+find out everything by my own. Thanks go to the excellent documentation
+of flex and bison and the Telos GmbH that published a simple interpreter.
+
+While i was writing this I recognised that it might be usefull at other
+things too. Everything that can be created by a cleartext template
+and some application logic can be created with this lib.
+
+## Requirements
+
+ * Gnu C
+ * Flex/Yack
+
+## Contributing
+
+Just email me.
+
+## License
+
+GNU General Public License Version 3 (GPLv3)
+
+> This program is free software: you can redistribute it and/or modify
+> it under the terms of the GNU General Public License as published by
+> the Free Software Foundation, either version 3 of the License, or
+> (at your option) any later version.
+>
+> This program is distributed in the hope that it will be useful,
+> but WITHOUT ANY WARRANTY; without even the implied warranty of
+> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+> GNU General Public License for more details.
+>
+> You should have received a copy of the GNU General Public License
+> along with this program. If not, see .
+
+## Author
+
+Georg Hopp <>