diff --git a/README.md b/README.md
index 5dbb080..eb948db 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,19 @@ we have a [code of
conduct](http://contributor-covenant.org/version/1/1/0/) that applies
to communication around the project.
+## Usage
+
+```javascript
+import {EditorView, basicSetup} from "codemirror"
+import {html} from "@codemirror/lang-html"
+
+const view = new EditorView({
+ parent: document.body,
+ doc: `\nHTML`,
+ extensions: [basicSetup, html()]
+})
+```
+
## API Reference
diff --git a/src/README.md b/src/README.md
index 0c4a07f..89eeeb7 100644
--- a/src/README.md
+++ b/src/README.md
@@ -19,6 +19,19 @@ we have a [code of
conduct](http://contributor-covenant.org/version/1/1/0/) that applies
to communication around the project.
+## Usage
+
+```javascript
+import {EditorView, basicSetup} from "codemirror"
+import {html} from "@codemirror/lang-html"
+
+const view = new EditorView({
+ parent: document.body,
+ doc: `\nHTML`,
+ extensions: [basicSetup, html()]
+})
+```
+
## API Reference
@html