diff --git a/README.md b/README.md
index 8068c12..13cb52d 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,21 @@
 # cpp-linter.github.io
+
+[![Website](https://img.shields.io/static/v1?logo=googlechrome&logoColor=white&label=Website&message=cpp-linter.github.io&color=yellow)](https://cpp-linter.github.io/)
+[![GitHub Org](https://img.shields.io/badge/github-cpp--linter-181717?logo=github)](https://github.com/cpp-linter)
+[![License](https://img.shields.io/github/license/cpp-linter/cpp-linter.github.io)](LICENSE)
+[![MkDocs](https://img.shields.io/badge/docs-MkDocs%20Material-526CFE?logo=materialformkdocs&logoColor=white)](https://cpp-linter.github.io/)
+
+Documentation website for the `cpp-linter` project and organization.
+
+This repository hosts the public site at <https://cpp-linter.github.io/>, including the homepage, getting started guides, and community links for the C/C++ linting ecosystem around `cpp-linter`.
+
+## Website
+
+- Main site: <https://cpp-linter.github.io/>
+- GitHub organization: <https://github.com/cpp-linter>
+
+## What You'll Find
+
+- Project overview and landing page content
+- Getting started documentation
+- Discussion and community entry points