docs: add recommended media type & file extension

docs/cli/index.md

@@ -87,6 +87,8 @@ cat data.toon | toon --decode
 
 :::
 
+By convention, TOON files use the `.toon` extension and the provisional media type `text/toon` (see [spec §18.2](https://github.com/toon-format/spec/blob/main/SPEC.md#182-provisional-media-type)).
+
 ### Standard Input
 
 Omit the input argument or use `-` to read from stdin. This enables piping data directly from other commands:

docs/ecosystem/implementations.md

@@ -1,6 +1,6 @@
 # Implementations
 
-TOON has official and community implementations across multiple programming languages. All implementations are intended to conform to the same [specification](https://github.com/toon-format/spec) to ensure compatibility and interoperability.
+TOON has official and community implementations across multiple programming languages. All implementations are intended to conform to the same [Specification](https://github.com/toon-format/spec) to ensure compatibility and interoperability.
 
 The code examples throughout this documentation site use the TypeScript implementation by default, but the format and concepts apply equally to all languages.
 

docs/ecosystem/tools-and-playgrounds.md

@@ -53,4 +53,4 @@ const toon = encode(data)
 const data = decode(toon)
 ```
 
-See the [API reference](/reference/api) for details.
+See the [API Reference](/reference/api) for details.

docs/guide/getting-started.md

@@ -234,8 +234,20 @@ console.log(JSON.stringify(data, null, 2))
 
 Round-tripping is lossless: `decode(encode(x))` always equals `x` (after normalization of non-JSON types like `Date`, `NaN`, etc.).
 
+## Media Type & File Extension
+
+When using TOON over HTTP or in content-type–aware systems:
+
+- Use `text/toon` as the media type (provisional; see [spec §18.2](https://github.com/toon-format/spec/blob/main/SPEC.md#182-provisional-media-type))
+- Use `.toon` as the standard file extension
+- TOON is always UTF-8 encoded; `charset=utf-8` is optional
+
+Example:
+
+```http
+Content-Type: text/toon; charset=utf-8
+```
+
 ## Where to Go Next
 
-Now that you've seen your first TOON document, read the [Format Overview](/guide/format-overview) for complete syntax details (objects, arrays, quoting rules, key folding), then explore [Using TOON with LLMs](/guide/llm-prompts) to see how to use it effectively in prompts. For implementation details, check the [API reference](/reference/api) (TypeScript) or the [specification](/reference/spec) (language-agnostic normative rules).
-
-For large datasets or streaming use-cases, see `encodeLines`, `decodeFromLines`, and `decodeStream` in the [API reference](/reference/api).
+Now that you've seen your first TOON document, read the [Format Overview](/guide/format-overview) for complete syntax details (objects, arrays, quoting rules, key folding), then explore [Using TOON with LLMs](/guide/llm-prompts) to see how to use it effectively in prompts. For implementation details, check the [API Reference](/reference/api) (TypeScript) or the [Specification](/reference/spec) (language-agnostic normative rules).

docs/guide/llm-prompts.md

@@ -83,7 +83,7 @@ catch (error) {
 }
 ```
 
-Strict mode checks counts, indentation, and escaping so you can detect truncation or malformed TOON. For complete details, see the [API reference](/reference/api#decode).
+Strict mode checks counts, indentation, and escaping so you can detect truncation or malformed TOON. For complete details, see the [API Reference](/reference/api#decode).
 
 ## Delimiter Choices for Token Efficiency
 
@@ -116,7 +116,7 @@ The CLI also supports streaming for memory-efficient JSON-to-TOON conversion:
 toon large-dataset.json --output output.toon
 ```
 
-This streaming approach prevents out-of-memory errors when preparing large context windows for LLMs. For complete details on `encodeLines()`, see the [API reference](/reference/api#encodelines).
+This streaming approach prevents out-of-memory errors when preparing large context windows for LLMs. For complete details on `encodeLines()`, see the [API Reference](/reference/api#encodelines).
 
 **Consuming streaming LLM outputs:** If your LLM client exposes streaming text and you buffer by lines, you can decode TOON incrementally:
 

docs/reference/spec.md

@@ -11,6 +11,11 @@ You don't need this page to *use* TOON. It's mainly for implementers and contrib
 
 **Spec v{{ $spec.version }}** (2025-11-10) is the current stable version.
 
+The spec defines a provisional media type and file extension in §18.2:
+
+- **Media type:** `text/toon` (provisional, UTF-8 only)
+- **File extension:** `.toon`
+
 ## Guided Tour of the Spec
 
 ### Core Concepts

docs/reference/syntax-cheatsheet.md

@@ -1,6 +1,6 @@
 # Syntax Cheatsheet
 
-Quick reference for mapping JSON to TOON format. For rigorous, normative syntax rules and edge cases, see the [specification](/reference/spec).
+Quick reference for mapping JSON to TOON format. For rigorous, normative syntax rules and edge cases, see the [Specification](/reference/spec).
 
 ## Objects