diff --git a/modules/tools/deft/README.org b/modules/tools/deft/README.org
index 651aa1632..ad2de827a 100644
--- a/modules/tools/deft/README.org
+++ b/modules/tools/deft/README.org
@@ -1,4 +1,11 @@
 #+TITLE: :tools deft
 
-* TODO write deft readme
+[[https://jblevins.org/projects/deft/][Deft]] is a major mode for browsing and filtering notes written in plain text
+formats, such as org-mode, markdown, and LaTeX.
 
+To use this module, in your config file set the value of the variable ~deft-directory~ to the folder in which you
+want to keep your notes. 
+
+The default note format is org-mode. You can change this by setting the value of
+the variable ~deft-default-extension~. Changing the value to ~"md"~ for example,
+will change the default note format to markdown.