diff --git a/lib/README.md b/lib/README.md
index 6b2eeac2c0d..ed55e31d6bb 100644
--- a/lib/README.md
+++ b/lib/README.md
@@ -1,2 +1,5 @@
-Crates in this directory are published to crates.io and obey semver.
-They *could* live in a separate repo, but we want to experiment with a monorepo setup.
+# lib
+
+Crates in this directory are published to [crates.io](https://crates.io) and obey semver.
+
+They _could_ live in a separate repo, but we want to experiment with a monorepo setup.