summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorAsko Nõmm <asko@nmm.ee>2025-01-12 15:19:15 +0200
committerAsko Nõmm <asko@nmm.ee>2025-01-12 15:19:15 +0200
commit6a075eac5ee63d735691545af90ac6d3f3f7ff8f (patch)
treef74625aede60252fdca71f3c7cd8791703018180 /README.md
parent1a908bb7aae140b5c556c6b4e903b803820429dc (diff)
Bump
Diffstat (limited to 'README.md')
-rw-r--r--README.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..69bac52
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# FlatMatter
+
+A YAML-like data serialization language with support for functions. FlatMatter is considered feature-complete and is
+intentionally kept simple. Bug fixes and performance improvements are still made, of course.
+
+Example FlatMatter:
+
+```yaml
+title: "My Blog"
+last_updated: (get-content "posts") / (limit 1) / (get "published_at") / (date "YYYY-mm-dd")
+posts: "posts" / get-content
+```
+
+FlatMatter aims to be more-or-less syntactically compatible with YAML for the simple reason of not
+needing new editor plugins to have syntax highlighting, but it differs in that there is no indentation,
+but instead dots to indicate hierarchy, like `site.title` which would result in a `site` object that
+contains the `title` key.
+
+FlatMatter also supports functions, allowing you to build your own data DSL, and functions can also be piped with the
+forward slash `/` character, meaning that the result of the left operation will be passed as the first argument
+of the next function, and so on, to produce an end result.
+
+## Install
+
+To be written ...
+
+## Usage
+
+To be written ...