---
name: cherry-note-markdown
description: Write and format notes in Cherry Note's Markdown syntax — including its custom extensions for text color (~={Cyan} text=~), highlights (=={Cyan} text==), callouts, collapsible details, task lists, alignment, and live arithmetic blocks. Use whenever a user asks you to draft, format, or convert content for Cherry Note, or mentions Cherry Note notes/.md files.
---

# Cherry Note Markdown

Cherry Note is a focused desktop writing app (Windows & macOS, with Linux coming soon). Notes are plain
Markdown `.md` files. This skill teaches you to produce content in Cherry Note's
Markdown, which is standard/CommonMark Markdown plus the custom extensions below.

## Docs

- [llms.txt](https://cherry-note.app/llms.txt): A brief overview of Cherry Note and the Markdown syntax it supports.
- [Full context](https://cherry-note.app/llms-full.txt): Complete app overview + the full Markdown syntax reference with examples.
- [AGENTS.md](https://cherry-note.app/AGENTS.md): Operating guide for AI agents producing Cherry Note content.
- [SKILL.md](https://cherry-note.app/SKILL.md): A loadable Agent Skill for writing Cherry Note Markdown.


## When to use this skill

- The user asks you to write, draft, reformat, outline, or convert something **for
  Cherry Note** (or references Cherry Note, its notes, or `.md` files it manages).
- The user pastes Cherry Note content and asks you to edit or extend it.

## How to apply it

1. Output **plain text** using the syntax below — do not wrap the whole note in a
   code block unless the user wants the raw source.
2. Use expressive features (color, highlight, callouts, details, task lists,
   arithmetic) when they add clarity; keep it clean otherwise.
3. Never invent tokens. If a feature isn't listed here, use standard Markdown.

## Syntax reference

### Headings & inline marks
- Headings: `#`, `##`, `###`, `####` (H1–H4).
- `**bold**`, `_italic_`, `__underline__`, `~~strikethrough~~`, `` `inline code` ``,
  `^{superscript}`, `_{subscript}`, `||small text||`.

### Color & highlight (custom)
- Text color: `~={ColorName} text here=~` — e.g. `~={Cyan} Cyan colored text=~`
- Highlight: `=={ColorName} text here==` — e.g. `=={Cyan} Cyan Highlighted Text==`
- Color names: `Red`, `Orange`, `Amber`, `Yellow`, `Lime`, `Green`, `Emerald`,
  `Teal`, `Cyan`, `Sky`, `Blue`, `Indigo`, `Purple`, `Fuchsia`, `Pink`, `Rose`.

### Alignment (custom)
Prefix a heading or a paragraph: `{<->}` centered · `{->}` right · `{==}` justified. Left is default.

### Lists
- Bullet `- item`, ordered `1. item`, task `- [ ] todo` / `- [x] done`. Nesting supported.

### Links, quotes, code, rules
- Link: `[text](https://url.com)` (inline marks allowed inside).
- Blockquote: `> text`.
- Fenced code block with optional language hint (e.g. ```` ```ts ````).
- Horizontal rule: `---`.

### Callout blocks (custom)
```
> [!NOTE] Title here
> Body text here.
```
Types: `NOTE`, `INFO`, `WARNING`, `IMPORTANT`, `SUCCESS`.

### Details / collapsible (custom)
```
:::details {theme: Blue}
Summary / title text
---
Content goes here.
:::
```
`theme` = one of `Yellow`, `Orange`, `Sienna`, `Red`, `Pink`, `Purple`, `Indigo`,
`Blue`, `Cyan`, `Green`, `Lime` (case-insensitive); other names render unthemed.
`isExpanded` = `true`/`false` (default `false`).

### Tables & images
- Standard Markdown tables (inline marks work in cells).
- Standard Markdown images.

### Arithmetic blocks (custom)
Fenced code block with language `cherry-note-arithmetic`. Evaluates live; `x` = `*`;
supports `++ -- += -= *= /=`, `let` variables (let keyword is optional), and mathjs units/conversions.
Add ` isolated` to the language for block-local variables (blocks are global by default).

````
```cherry-note-arithmetic
price = 120
tax = price * 0.2
price + tax
4 kg to g
```
````

### Emoji
Supported (e.g. 🍒).