# Orcanote Markdown

> Create and edit Orca Note Flavored Markdown with callouts, highlights, Excalidraw based whiteboard, mermaid and other Orca Note-specific syntax. Use when inserting markdown into Orca Note, or when user mentions writing notes, callouts, highlights, Excalidraw, whiteboard, mermaid or Orca Note notes.

- **Type:** Skill
- **Install:** `agentstack add skill-sethyuan-orcanote-agent-skills-orcanote-markdown`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sethyuan](https://agentstack.voostack.com/s/sethyuan)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sethyuan](https://github.com/sethyuan)
- **Source:** https://github.com/sethyuan/orcanote-agent-skills/tree/main/skills/orcanote-markdown

## Install

```sh
agentstack add skill-sethyuan-orcanote-agent-skills-orcanote-markdown
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Orca Note Flavored Markdown Skill

This skill enables skills-compatible agents to create and edit valid Orca Note Flavored Markdown, including all Orca Note-specific syntax extensions.

## Overview

Orca Note uses a combination of Markdown flavors:
- [CommonMark](https://commonmark.org/)
- [GitHub Flavored Markdown](https://github.github.com/gfm/)
- [LaTeX](https://www.latex-project.org/) for math
- Orca Note-specific extensions (auto headings, highlights, callouts, etc.)

## Basic Formatting

### Paragraphs and Line Breaks

```markdown
This is a paragraph.

This is another paragraph (blank line between creates separate paragraphs).
```

### Headings

```markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
```

Maximum heading level is 4 (`####`).

### Text Formatting

| Style | Syntax | Example | Output |
|-------|--------|---------|--------|
| Bold | `**text**` or `__text__` | `**Bold**` | **Bold** |
| Italic | `*text*` or `_text_` | `*Italic*` | *Italic* |
| Bold + Italic | `***text***` | `***Both***` | ***Both*** |
| Strikethrough | `~~text~~` | `~~Striked~~` | ~~Striked~~ |
| Highlight | `==text==` | `==Highlighted==` | ==Highlighted== |
| Inline code | `` `code` `` | `` `code` `` | `code` |

### Escaping Formatting

Use backslash to escape special characters:
```markdown
\*This won't be italic\*
\#This won't be a heading
1\. This won't be a list item
```

Common characters to escape: `\*`, `\_`, `\#`, `` \` ``, `\|`, `\~`

## Link to Blocks

```markdown
[[BlockID]]
[[Block Alias]]
```

Block ID is a number.

## Markdown-Style Links

```markdown
[Display Text](https://example.com)
[Link used outside of Orca Note](orca-note://[repo]/block?blockId=[blockId])
```

Note: Spaces must be URL-encoded as `%20` in Markdown links.

## Images, Videos & Audios

```markdown

```

## Video/Audio Timestamps

```markdown
{01:59:59}
{59:59}
```

## Callouts

### Basic Callout

```markdown
> [!note]
> This is a notice callout.
```

### Nested Callouts

```markdown
> [!info]
> Outer callout
> > [!note]
> > Inner callout
```

### Supported Callout Types

| Type | Description |
|------|-------------|
| `info` | Blue, info icon |
| `warning` | Orange, warning icon |
| `error` | Red, exclamation icon |
| `tip` | Green, bulb icon |
| `important` | Purple, exclamation icon |
| `note` | Grey, note icon |

## Lists

### Unordered Lists

```markdown
- Item 1
- Item 2
  - Nested item
  - Another nested
- Item 3
```

### Ordered Lists

```markdown
1. First item
2. Second item
   1. Nested numbered
   2. Another nested
3. Third item
```

### Task Lists

```markdown
- [ ] Incomplete task
- [x] Completed task
- [ ] Task with sub-tasks
  - [ ] Subtask 1
  - [x] Subtask 2
```

## Quotes

```markdown
> This is a blockquote.
> It can span multiple lines.
>
> And include multiple paragraphs.
>
> > Nested quotes work too.
```

## Code

### Inline Code

```markdown
Use `backticks` for inline code.
Use double backticks for ``code with a ` backtick inside``.
```

### Code Blocks

````markdown
```
Plain code block
```

```javascript
// Syntax highlighted code block
function hello() {
  console.log("Hello, world!");
}
```

```python
# Python example
def greet(name):
    print(f"Hello, {name}!")
```
````

## Tables

```markdown
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |
```

## Math (LaTeX)

### Inline Math

```markdown
This is inline math: $e^{i\pi} + 1 = 0$
```

### Block Math

```markdown
$$
\begin{vmatrix}
a & b \\
c & d
\end{vmatrix} = ad - bc
$$
```

### Common Math Syntax

```markdown
$x^2$              Superscript
$x_i$              Subscript
$\frac{a}{b}$      Fraction
$\sqrt{x}$         Square root
$\sum_{i=1}^{n}$   Summation
$\int_a^b$         Integral
$\alpha, \beta$    Greek letters
```

## Diagrams (Mermaid)

````markdown
```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do this]
    B -->|No| D[Do that]
    C --> E[End]
    D --> E
```
````

## Whiteboard (Excalidraw)

````markdown
```whiteboard
{
  "elements": [...],
  "files": {}
}
```
````

## Horizontal Rules

```markdown
---
***
___
- - -
* * *
```

## Complete Example

````markdown
# Project Alpha

## Overview

This project aims to improve workflow using modern techniques.

> [!important]
> The first milestone is due on ==January 30th==.

## Tasks

- [x] Initial planning
- [x] Resource allocation
- [ ] Development phase
  - [ ] Backend implementation
  - [ ] Frontend design
- [ ] Testing
- [ ] Deployment

## Technical Notes

The main algorithm uses the formula $O(n \log n)$ for sorting.

```python
def process_data(items):
    return sorted(items, key=lambda x: x.priority)
```

## Architecture

```mermaid
graph LR
    A[Input] --> B[Process]
    B --> C[Output]
    B --> D[Cache]
```
````

## References

- See `orcanote-mermaid` skill for Mermaid syntax and more details.
- See `orcanote-whiteboard` skill for whiteboard syntax (based on Excalidraw) and more details.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sethyuan](https://github.com/sethyuan)
- **Source:** [sethyuan/orcanote-agent-skills](https://github.com/sethyuan/orcanote-agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sethyuan-orcanote-agent-skills-orcanote-markdown
- Seller: https://agentstack.voostack.com/s/sethyuan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.