> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Cognite Data Fusion (CDF) is an industrial DataOps platform. Prefer English docs unless the user asks for another locale.
> Follow /_llms/ index links recursively until you reach page URLs ending in .md. Fetch those Markdown twins instead of HTML.
> For REST APIs, default to calendar version 20230101 (stable). Use 20230101-beta or 20230101-alpha only if the user is on a preview API. Cite paths under /api-reference/concepts/<version>/ and the Cdf-Version header. Prefer the Python SDK (cognite-sdk) unless the user is in JavaScript/TypeScript.
> Start here by task: platform overview /cdf/index.md; data modeling /cdf/dm/index.md; data integration /cdf/integration/index.md; access /cdf/access/index.md; CDF Toolkit /cdf/deploy/cdf_toolkit/index.md; REST quickstart /dev/quickstart.md; Python SDK /dev/sdks/python/index.md; Atlas AI /cdf/atlas_ai/concepts/index.md; Flows apps /cdf/flows/index.md; MCP and IDE setup /dev/guides/ide_ai_integration.md.
> For implementation work, also load /skill.md.

# Code block

> Formatted display of code snippets with syntax highlighting for documentation and in-product technical content.

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/ai-code-block--docs)

## When to use

* Display code samples, configuration snippets, or query examples in documentation and product UI.
* Show generated or copyable technical content where syntax highlighting improves readability.
* Present short, self-contained examples that users may copy into their own workflows.

## When to use something else

* For editable multi-line text entry, use [Textarea](/aura-design-system/primitives/textarea).
* For single-line values such as IDs or tokens, use [Input](/aura-design-system/primitives/input).
* For file upload of source files, use [File upload](/aura-design-system/primitives/file-upload).

## Dos and don'ts

* **Do** provide a clear language or context label when the syntax isn't obvious from surrounding copy.
* **Do** keep examples focused on the task the user is completing.
* **Don't** dump entire files when a short, relevant excerpt is enough.
* **Don't** rely on color alone to convey meaning in highlighted code — keep structure and indentation clear.

## Behavior

* Prefer a copy control for short snippets; announce success with a brief status message or [Sonner](/aura-design-system/primitives/sonner) rather than relying on visual change alone.
* When content overflows the viewport, pair with [Scroll](/aura-design-system/primitives/scroll-area) so keyboard and pointer users can reach the full snippet.

## Often used with

[Card](/aura-design-system/primitives/card), [Dialog](/aura-design-system/primitives/dialog), [Scroll](/aura-design-system/primitives/scroll-area), and copy actions via [Button](/aura-design-system/primitives/button).

## Accessibility

* **Expose language:** Include a visible or programmatically associated language label when highlighting is used so screen reader users understand the code context.
* **Name copy actions:** Give copy [Button](/aura-design-system/primitives/button)s an explicit accessible name (for example, `aria-label="Copy code snippet"`).
* **Don't rely on color alone:** Keep indentation and structure clear; syntax colors are supplemental.