Smart Context codeblock

The Smart Context Codeblock keeps a visible context manifest inside the note that needs it.

Use it when the note body contains the instructions, and the codeblock contains the exact notes or named contexts that should travel with those instructions.

Insert the codeblock

Core command:

Smart Context: Insert codeblock (add notes & named contexts)

Pro command:

Smart Context: Insert codeblock (add external files & named contexts)

Run the command from any note to insert the block and start editing it in place.

Supported aliases

All three aliases render the same native UI:

```ctx
Projects/Alpha/Brief.md
ctx:: Weekly planning
```

ctx
context
smart-context

The original alias is preserved when the block is rewritten.

Empty state and actions

An empty codeblock renders a compact Smart Context UI directly in the note.

The codeblock stays in the note, so you can manage local context without switching to another surface.

Open the codeblock menu

The menu exposes the main actions for the current codeblock.

The current menu shown here includes:

Create named context
Open context builder
Copy context to clipboard
Open named contexts dashboard
Help

Create named context is the fastest way to turn a local codeblock working set into one reusable named context.

When the block has context items

Once the block contains items, the UI shows live size estimates in the action bar.

The copy button becomes the fastest way to export the current codeblock context.

After copy, the notice confirms the export immediately inside Obsidian.

What gets written into the block

Whole sources are stored as one line per source:

A named context is stored as a single named-context line:

That keeps the raw markdown readable and easy to diff.

Example:

```ctx
Personal Productivity/Tools & Systems/Productivity Apps & Tools.md
PKM/Advanced/Integrating Tools and Techniques.md
PKM/Basics/Capture Tools.md
```

Named-context example:

```ctx
ctx:: Smart Context 2026-03-26
```

Copy behavior

Use the codeblock copy action when you want only the codeblock context.

Use the regular current-note copy command when you want:

the current note
the hydrated codeblock context
one combined clipboard bundle

In that current-note flow, codeblock items are treated as depth 0.

Pro adds external files and folders

On Pro, the same codeblock surface also accepts:

external files
external folders
exclusion lines starting with !

That lets one note carry both the writing instructions and the external repo files that should travel with them.