diff --git a/project.clj b/project.clj
index 9bac411..f1b2f37 100644
--- a/project.clj
+++ b/project.clj
@@ -13,6 +13,7 @@
                  [bidi "2.1.6"]
                  [byte-streams "0.2.4"]
                  [cheshire "5.11.0"]
+                 [clj-commons/clj-yaml "1.0.26"]
                  [clj-http "3.12.3"]
                  [clj-time "0.15.2"]
                  [com.amazonaws/aws-java-sdk-core "1.12.276"]
@@ -31,6 +32,7 @@
                  [honeysql "1.0.461"]
                  [io.micrometer/micrometer-registry-prometheus "1.9.2"]
                  [less-awful-ssl "1.0.6"]
+                 [markdown-clj "1.11.4"]
                  [mount "0.1.16"]
                  [org.slf4j/slf4j-api                           ~slf4j-version]
                  [org.slf4j/log4j-over-slf4j                    ~slf4j-version]
diff --git a/src/meuse/front/pages/crate.clj b/src/meuse/front/pages/crate.clj
index 3cd9f82..d082620 100644
--- a/src/meuse/front/pages/crate.clj
+++ b/src/meuse/front/pages/crate.clj
@@ -1,5 +1,6 @@
 (ns meuse.front.pages.crate
-  (:require [meuse.db.public.crate :as public-crate]))
+  (:require [meuse.db.public.crate :as public-crate]
+            [markdown.core :as md]))
 
 ; missing metadata:
 ;   - features
@@ -82,7 +83,8 @@
          [:span.hl-string \" version-str \"]]]
 
        [:div.readme
-        ;; TODO: show README
+        (when-let [readme (:readme metadata)]
+          (md/md-to-html-string readme))
         ]]
 
       ;; right column