docs: add project vision: about page, concept doc, and homepage update.

site/about.md

@@ -0,0 +1,39 @@
+---
+title: About MarkdownDB
+---
+
+# About MarkdownDB
+
+MarkdownDB is a JavaScript library that turns a folder of markdown files into a queryable database. It extracts structured data — frontmatter, tags, links, tasks — indexes it into SQLite, and gives you a clean API to query across your content.
+
+Your files stay as plain text. You get the power of a database.
+
+## Why it exists
+
+Most content lives in one of two places: a CMS (structured and queryable, but locked in a platform) or plain markdown files (free and portable, but unqueryable). That's a false choice.
+
+Markdown files already contain structured data. Frontmatter fields, inline tags, links between pages, tasks — it's all there, sitting unused. MarkdownDB extracts it, indexes it, and makes it queryable.
+
+The underlying idea has a name: the [Markdown Database Pattern](https://markdownisawesome.com/markdown-database). MarkdownDB is its implementation in JavaScript.
+
+## What makes it different
+
+Other tools in this space — Contentlayer, Nuxt Content, Astro content collections — mix content indexing with rendering and tie you to a particular framework. MarkdownDB does one thing: build the index and provide the API. What you do with the data is up to you.
+
+- **Stack-agnostic** — works with any JavaScript framework, or none at all
+- **SQL-native** — standard SQL on a real SQLite database, no custom query language
+- **Focused** — does not own your render pipeline
+- **Extracts more than frontmatter** — inline tags, wikilinks, backlinks, tasks
+- **Open source** — MIT licensed, your content never locked in
+
+## The vision
+
+We believe content should be owned, open, and durable.
+
+Markdown is the closest thing the web has to a universal content format — plain text, readable without tools, writable in anything, storable in git. But choosing markdown has always meant giving up queryability. MarkdownDB closes that gap.
+
+The goal is a world where you never have to choose between the freedom of plain text and the power of structured data.
+
+## Built by Flowershow
+
+MarkdownDB is built and maintained by [Flowershow](https://flowershow.app), a team working on markdown-native tools for publishing and managing content. It is open source and contributions are welcome on [GitHub](https://github.com/flowershow/markdowndb).

site/index.md

@@ -177,10 +177,12 @@ client.indexFolder({
 <div class="mx-auto max-w-6xl py-16 px-6 lg:px-8">
   <div class="text-center max-w-3xl mx-auto">
     <p class="text-base font-semibold text-indigo-600">Our vision</p>
-    <h2 class="mt-2 text-3xl font-bold tracking-tight text-gray-900 sm:text-4xl">Unified Content Management</h2>
+    <h2 class="mt-2 text-3xl font-bold tracking-tight text-gray-900 sm:text-4xl">Your content, your database</h2>
     <p class="mt-6 text-lg leading-8 text-gray-600">
-      Imagine a world where Markdown isn't just text &ndash; it's a source of structured and unstructured data. With MarkdownDB, we aim to balance the simplicity and accessibility of writing in Markdown with the <strong>ability to query your collection of markdown files like a database</strong> &ndash; think get me all files "with type Blog" or "all documents created in the last week" or "all documents with 'hello world' in the title" or find "all tasks (i.e. <code>- [ ]</code>) in all documents".
+      Markdown files already contain structured data &mdash; frontmatter fields, tags, links, tasks. Most tools ignore it. MarkdownDB extracts it, indexes it, and makes it queryable, without touching your files or locking you into a platform.
     </p>
+    <p class="mt-4 text-lg font-medium text-gray-900">Plain text in. Rich queryable data out.</p>
+    <p class="mt-4 text-sm text-gray-500">Learn more about the <a href="https://markdownisawesome.com/markdown-database" class="text-indigo-600 hover:text-indigo-500">Markdown Database Pattern &rarr;</a></p>
   </div>
 </div>