diff --git a/site/about.md b/site/about.md new file mode 100644 index 0000000..c4be6fb --- /dev/null +++ b/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). diff --git a/site/index.md b/site/index.md index 5462dc5..e6e0ce6 100644 --- a/site/index.md +++ b/site/index.md @@ -177,10 +177,12 @@ client.indexFolder({

Our vision

-

Unified Content Management

+

Your content, your database

- Imagine a world where Markdown isn't just text – 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 ability to query your collection of markdown files like a database – 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. - [ ]) in all documents". + Markdown files already contain structured data — 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.

+

Plain text in. Rich queryable data out.

+

Learn more about the Markdown Database Pattern →