diff --git a/dfg/examples/proposal/README b/dfg/examples/proposal/README
deleted file mode 100644
index 9508f42..0000000
--- a/dfg/examples/proposal/README
+++ /dev/null
@@ -1,22 +0,0 @@
-An Example for dfgproposal.cls (multi-site proposal)
-
-proposal.tex              is a fake DFG proposal that shows all elements of 
-                          dfgproposal.cls in action.
-finalreport.tex		  does the same for dfgreporting.cls         
-CV_PubList_Kohlhase.tex   is an example of the CV and publication lists required 
-			  by the DFG
-letter_submission.tex	  is an example submission letter. 
-*.tex			  the rest are intemediate files
-doc 			  contains the DFG documentation how to write proposals and 
-			  final reports: These documents are not subject to the 
-			  package's license but (c) DFG.  They are bundled for your 
-			  convenience; up-to-date versions may be found at http://www.dfg.de.
-Makefile                  allows the automation via a unix Makefile on the author's 
-			  machine, adapt it to your needs
-
-Copyright(c) 2010 Michael Kohlhase
-The package is distributed under the terms of the LaTeX Project Public License (LPPL)
-
-The development version of this package can be found at
-https://svn.kwarc.info/repos/kwarc/doc/macros/forCTAN/dfgproposal/ex
-
diff --git a/dfg/examples/proposal/README.md b/dfg/examples/proposal/README.md
new file mode 100644
index 0000000..f73ab56
--- /dev/null
+++ b/dfg/examples/proposal/README.md
@@ -0,0 +1,20 @@
+# An Example for dfgproposal.cls (multi-site proposal)
+
+
+| ```proposal.tex``` | is a fake DFG proposal that shows all elements of ```dfgproposal.cls``` in action.|
+|```finalreport.tex``` | does the same for ```dfgreporting.cls```
+|```CV_PubList_Kohlhase.tex``` | is an example of the CV and publication lists required by the DFG|
+|```letter_submission.tex``` | is an example submission letter. | 
+|```*.tex``` |  the rest are intemediate files|
+| ```doc```| contains the DFG documentation how to write proposals and 
+			  final reports: These documents are not subject to the 
+			  package's license but (c) DFG.  They are bundled for your 
+			  convenience; up-to-date versions may be found at http://www.dfg.de.|
+|```Makefile```| allows the automation via a unix Makefile on the author's machine, adapt it to your needs.|
+
+Copyright(c) 2010 Michael Kohlhase
+The package is distributed under the terms of the LaTeX Project Public License (LPPL)
+
+The development version of this package can be found at
+https://github.com/KWARC/LaTeX-Proposal/dfg/examples/proposal
+
diff --git a/dfg/examples/simple-proposal/README b/dfg/examples/simple-proposal/README
deleted file mode 100644
index 00316fd..0000000
--- a/dfg/examples/simple-proposal/README
+++ /dev/null
@@ -1,22 +0,0 @@
-An Example for dfgproposal.cls (simple proposal)
-
-proposal.tex              is a fake DFG proposal that shows all elements of 
-                          dfgproposal.cls in action.
-finalreport.tex		  does the same for dfgreporting.cls         
-CV_PubList_Kohlhase.tex   is an example of the CV and publication lists required 
-			  by the DFG
-letter_submission.tex	  is an example submission letter. 
-*.tex			  the rest are intemediate files
-doc 			  contains the DFG documentation how to write proposals and 
-			  final reports: These documents are not subject to the 
-			  package's license but (c) DFG.  They are bundled for your 
-			  convenience; up-to-date versions may be found at http://www.dfg.de.
-Makefile                  allows the automation via a unix Makefile on the author's 
-			  machine, adapt it to your needs
-
-Copyright(c) 2010 Michael Kohlhase
-The package is distributed under the terms of the LaTeX Project Public License (LPPL)
-
-The development version of this package can be found at
-https://svn.kwarc.info/repos/kwarc/doc/macros/forCTAN/dfgproposal/ex
-
diff --git a/dfg/examples/simple-proposal/README.md b/dfg/examples/simple-proposal/README.md
new file mode 100644
index 0000000..e9581df
--- /dev/null
+++ b/dfg/examples/simple-proposal/README.md
@@ -0,0 +1,20 @@
+An Example for dfgproposal.cls (simple proposal)
+
+
+| ```proposal.tex``` | is a fake DFG proposal that shows all elements of ```dfgproposal.cls``` in action.|
+|```finalreport.tex``` | does the same for ```dfgreporting.cls```
+|```CV_PubList_Kohlhase.tex``` | is an example of the CV and publication lists required by the DFG|
+|```letter_submission.tex``` | is an example submission letter. | 
+|```*.tex``` |  the rest are intemediate files|
+| ```doc```| contains the DFG documentation how to write proposals and 
+			  final reports: These documents are not subject to the 
+			  package's license but (c) DFG.  They are bundled for your 
+			  convenience; up-to-date versions may be found at http://www.dfg.de.|
+|```Makefile```| allows the automation via a unix Makefile on the author's machine, adapt it to your needs.|
+
+Copyright(c) 2010 Michael Kohlhase
+The package is distributed under the terms of the LaTeX Project Public License (LPPL)
+
+The development version of this package can be found at
+https://github.com/KWARC/LaTeX-Proposal/dfg/examples/simple-proposal
+