diff --git a/README.md b/README.md
index bf91097cd..43ee5c7fc 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,7 @@ https://user-images.githubusercontent.com/3120367/206125010-bd1fea8e-248a-43e7-8
-
- Misc
- FAQ
+- Open-source projects documenting with D2
## What does D2 look like?
@@ -240,3 +241,21 @@ let us know and we'll be happy to include it here!
- Please open up a Github Issue.
- I have a private inquiry.
- Please reach out at [hi@d2lang.com](hi@d2lang.com).
+
+## Open-source projects documenting with D2
+
+Do you have or see an open-source project with `.d2` files? Please submit a PR adding to
+this list (ordered by star count, desc).
+
+- [Block Protocol](https://github.com/blockprotocol/blockprotocol) - The Block Protocol is
+ an open standard for building and using data-driven blocks.
+- [Ivy Wallet](https://github.com/Ivy-Apps/ivy-wallet) - Ivy Wallet is an open-source
+ money manager app for Android.
+- [Learn EVM Attacks](https://github.com/coinspect/learn-evm-attacks) - Learn & Contribute
+ on previously exploited vulnerabilities across several EVM projects.
+- [BYCEPS](https://github.com/byceps/byceps) - BYCEPS is a self-hosted web platform to run
+ LAN parties.
+- [Re:Earth](https://github.com/reearth/reearth-web) - A free, open and highly extensible
+ WebGIS platform.
+- [Terraform OCI VSCode Server](https://github.com/timoa/terraform-oci-vscode-server) -
+ Terraform project that deploys VSCode Server on Oracle Cloud Infrastructure.