diff --git a/README.md b/README.md
index 2dc22d3..7d13ecc 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,12 @@
-gemini://sixohthree.com/log/publishing-to-the-gemlog-with-logseq.gmi
+# logseq2gemtext
+
+This project converts an index of Markdown files (in my case, created in logseq) into Gemtext, with a corresponding Gemlog index. Some parts, including the resulting directory structure, are specific to my own needs and may not be suitable for every use case.
+
+More information: [gemini://sixohthree.com/log/publishing-to-the-gemlog-with-logseq.gmi][1]
+
+## TODO
+
+* Additional configuration options
+* Move more functionality out of `run.php` and into tested classes
+
+[1]: gemini://sixohthree.com/log/publishing-to-the-gemlog-with-logseq.gmi