diff --git a/docs/component-usage.md b/docs/component-usage.md
index 3a7e768..53eb8fc 100644
--- a/docs/component-usage.md
+++ b/docs/component-usage.md
@@ -144,3 +144,11 @@ Use semantic HTML first. Add ARIA only when native semantics are not enough.
- **Responsive narrow rows:** `data-label` on each cell
- **Numeric columns:** `data-numeric="true"` and `data-align="end"`
- **Status column:** `data-column="status"` on header and cells to keep status output aligned
+
+## Code Block
+
+- **Block:** `
` wrapping a `` child for multi-line snippets
+- **Language tag:** `data-language="bash"`, `data-language="html"`, etc. surfaces a small uppercase label in the top-left of the block. Tag is decorative, not announced.
+- **Inline:** `` for short opt-in inline runs that need a stronger visual edge than the body `` default. Use plain `` for in-prose runs that should blend.
+- **Long lines:** the block scrolls horizontally; do not pre-wrap. Authors may add explicit line breaks for narrow surfaces.
+- Keep snippets short. For longer programs, link out to a file in the repo and quote the relevant block.
diff --git a/examples/playground.html b/examples/playground.html
index 9ba95f9..9443b3f 100644
--- a/examples/playground.html
+++ b/examples/playground.html
@@ -69,6 +69,7 @@
"toolbar toolbar toolbar toolbar toolbar toolbar toolbar toolbar form form form form"
"telemetry telemetry telemetry telemetry card card card card navigation navigation navigation navigation"
"details details details details rows rows rows rows rows rows rows rows"
+ "code code code code code code code code code code code code"
"states states states states states states states states states states states states";
}
@@ -117,6 +118,10 @@
grid-area: toolbar;
}
+ .playground-code-preview {
+ grid-area: code;
+ }
+
.state-matrix {
display: grid;
gap: 1rem;
@@ -138,6 +143,7 @@
"card card card card card card telemetry telemetry telemetry telemetry telemetry telemetry"
"navigation navigation navigation navigation navigation navigation details details details details details details"
"rows rows rows rows rows rows rows rows rows rows rows rows"
+ "code code code code code code code code code code code code"
"states states states states states states states states states states states states";
}
@@ -170,6 +176,7 @@
"toolbar toolbar toolbar toolbar toolbar toolbar toolbar toolbar toolbar toolbar toolbar toolbar"
"navigation navigation navigation navigation navigation navigation navigation navigation navigation navigation navigation navigation"
"rows rows rows rows rows rows rows rows rows rows rows rows"
+ "code code code code code code code code code code code code"
"states states states states states states states states states states states states";
}
@@ -449,6 +456,26 @@ Toolbar
+
+
+ Inline runs and multi-line blocks with an optional language tag.
+
+
+ Install with
+ npm install elumkit
+ or copy the source.
+
+
+ npm install elumkit
+npm run playground
+
+ <pre class="elum-pre" data-language="bash">
+ <code>echo hello</code>
+</pre>
+
+