diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..f35d524
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,25 @@
+# markdown-archiver
+
+Library for creating self-contained markdown files by embedding images.
+
+## Installation
+
+The library is published to [jsr.io](https://jsr.io/) and can be installed into
+your TypeScript project by utilizing your respective package manager:
+
+```sh
+deno add @openformation/markdown-archiver
+# OR
+```
+
+## Usage
+
+TBD
+
+## Contributing
+
+TBD
+
+## License
+
+TBD