siyuan-mcp-markup-guide

name	siyuan-mcp-markup-guide
description	MCP SiYuan markup guide for rich Markdown written through block and document actions. Use for headings, lists, tasks, tables, code, math, diagrams, tags, callouts, super blocks, embeds, and block references.

SiYuan Markup Guide with MCP

Pass rich content as Markdown to block or document write actions. Keep each write bounded and read the result after insertion.

block(action="append", parentID="<doc-id>", dataType="markdown", data="## Heading\n\nParagraph with **bold** text.")

Common markup

# Heading

**bold**, *italic*, ~~deleted~~, ==highlight==, `inline code`, #tag#

- Item
  - Nested item
- [ ] Task

| Name | Status |
| --- | --- |
| Draft | Done |

> **Note**
>
> Keep evidence with the decision.

Use an attribute view for real database behavior rather than a Markdown table.

Math and diagrams

Inline: $e^{i\pi}+1=0$

$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

```mermaid
flowchart TD
  A[Start] --> B[Done]
```

SiYuan-specific forms

• Block reference: ((<block-id> "Optional label"))
• Embed query: {{SELECT id, content FROM blocks WHERE content LIKE '%TODO%' LIMIT 20}}
• Horizontal super block: wrap sibling blocks in {{{row and }}}.
• Vertical super block: wrap sibling blocks in {{{col and }}}.
• IAL attributes: {: custom-key="value"}; use dedicated attribute actions for programmatic metadata.

Do not invent unsupported Markdown extensions. For detailed layout rules or unfamiliar write fields, inspect siyuan://help/action/block/append before writing.