diff --git a/docs/README.md b/docs/README.md
index 4bad84cd7..6a9f50b45 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,4 +1,4 @@
-Pilosa docs are maintained here, to stay in sync with the codebase.
+Pilosa docs are maintained here, to stay in sync with the codebase. The format is [Blackfriday](https://github.com/russross/blackfriday) markdown, with some Hugo [front matter](https://gohugo.io/content-management/front-matter/).
 
 Please visit [our website](https://www.pilosa.com/docs/) to view the docs complete with styles, diagrams, and comprehensive search.