Mermaid Diagram Skill

This skill enables accurate creation of Mermaid diagrams inside Obsidian Markdown files. The rules and selection guide below always apply; load [reference/diagram-types.md](reference/diagram-types.md) for the exact syntax and a worked example of any specific diagram type.

⚠️ Global Syntax Rules (MUST FOLLOW)

1. NO full-width punctuation inside code blocks. All parentheses, commas, colons, and symbols MUST be half-width (English) characters.

- ❌ ， 。 ！ （ ） ： - ✅ , . ! ( ) :

1. Quote node labels containing special characters like (), [], {} using double quotes: A["Label (info)"]
2. No HTML tags in labels (use <br/> only when explicitly needed for line breaks).
3. Indentation matters in mindmaps and timelines — use spaces only, never - or * .
4. Flowcharts default to flowchart TD (top-down) unless the user asks otherwise.
5. Read deeporbit.json from the workspace root to determine the interaction language. Use this language for all your responses and generated note contents (e.g. zh-CN). The Obsidian folder paths themselves will ALWAYS remain in English.

• Set author: ai in frontmatter for every note you create; switch to author: mixed when substantially rewriting a human-authored note. Authorship lives in frontmatter only — never add visible badges.

Diagram Selection Guide

Pick the type from this table, then open [reference/diagram-types.md](reference/diagram-types.md) for its full syntax, node shapes, and a complete example.

Flowchart quick reference (the most common case)

Direction: TD/TB (top-down, default), LR, BT, RL.

flowchart TD
    A[User Input] --> B{Input Type?}
    B -->|URL| C[Fetch Content]
    B -->|PDF| D[Extract Text]
    C --> F[Summarize]
    D --> F
    F --> G[(Save to Vault)]

[!CAUTION]
Conditional edges MUST use the double pipe |: A -->|Yes| B. Never write A --> Yes B or A --Yes--> B.

For node shapes, link types, subgraphs, and styling, see the Flowchart section of [reference/diagram-types.md](reference/diagram-types.md).

Common Pitfalls