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

# File Directives

File directives let external files control how their linked blocks appear in Bentowise. Add them using HTML comments in the source file.

## Available directives

| Directive | Purpose | Supported files | Since |
| :- | :- | :- | :- |
| `bentowise:color` | Set the linked block’s color | `.md`, `.markdown`, `.txt` | v2.8.1 |

Additional directives will be documented here as they become available.

## File color

Place this declaration on the **first non-empty line** of your file:

```text theme={null}
<!-- bentowise:color=green -->

# Research summary

Your content goes here.
```

Supported values: `default`, `red`, `orange`, `yellow`, `green`, `blue`, `purple`.

Use one declaration per file, with an unquoted color name. Names are case-insensitive; custom colors and HEX codes are not supported.

### How it works

* Linked blocks follow the file’s color by default and update when Bentowise refreshes the file.
* Use **Follow file color** in the block’s details panel to enable or disable following.
* Choosing a color manually disables following. Your manual color is preserved.
* Removing the declaration or using an invalid value restores the saved manual color.
* `default` selects Bentowise’s default theme; it does not disable following.

The declaration is hidden from the preview but remains in the source file and copied original text. Bentowise does not rewrite the file when you change a block’s color settings.

### Workflow example

You or an AI tool might use `yellow` for drafts and `green` for reviewed material. These meanings are yours to define—Bentowise only applies the declared color.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.