diff --git a/README.md b/README.md
index 5d1bec4..db75284 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,31 @@
-# awesome-duckdb
-A curated list of awesome DuckDB resources
+# Awesome DuckDB [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
+
+> A curated list of awesome DuckDB libraries, tools and resources.
+
+[DuckDB](https://duckdb.org/) is an in-process SQL OLAP database management system.
+
+## Contents
+
+- [Section](#section)
+- [Another Section](#another-section)
+
+
+## Section
+
+About this section. Optional. Keep this short and focus on the list.
+
+- [List item](http://example.com)
+- [List item](http://example.com)
+
+
+## Another Section
+
+### Subsection
+
+- [List item](http://example.com)
+- [List item](http://example.com)
+
+
+## Contribute
+
+Contributions welcome! Read the [contribution guidelines](contributing.md) first.