Obsidian Mermaid

Create Obsidian-compatible Mermaid diagrams. Prefer square layouts (TB + subgraph LR), avoid markdown in labels. Use when creating flowcharts, sequence diagrams, or any Mermaid diagrams in markdown files.

52 stars 10 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jykim/claude-obsidian-skills --skill obsidian-mermaid
Manual install
git clone --depth 1 https://github.com/jykim/claude-obsidian-skills.git /tmp/claude-obsidian-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-obsidian-skills/obsidian-mermaid ~/.claude/skills/obsidian-mermaid

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Obsidian Mermaid Diagrams

Create Mermaid diagrams that render correctly in Obsidian and publish without issues.

## When to Use This Skill

Activate when you need to:
- Create flowcharts, sequence diagrams, ER diagrams
- Convert ASCII art to Mermaid
- Fix Mermaid rendering errors in Obsidian

## Core Principle: Simplicity First

> **다이어그램은 한눈에 들어와야 한다**

복잡한 다이어그램은 읽기 어렵다. 항상 최소한의 노드와 연결로 핵심만 표현하라.

### Node Minimization

**Before** (9개 노드):
```mermaid
flowchart LR
    A[수집] --> B[정리] --> C[보관]
    D[목표] --> E[학습] --> F[실행] --> G[측정] --> H[달성]
```

**After** (2개 노드 - 순차 흐름을 노드 내 텍스트로):
```mermaid
flowchart LR
    A[수집 → 정리 → 보관]
    B[목표 → 학습 → 실행 → 달성]
```

### Connection Minimization

- 핵심 흐름만 표현, 세부사항은 본문에서 설명
- 노드 5개 이하, 연결선 교차 금지
- 복잡한 관계는 여러 개의 단순한 다이어그램으로 분리

### Table vs Mermaid 선택

| 형식 | 용도 | 예시 |
|------|------|------|
| **테이블** | 속성-값 매핑, 비교, 옵션 | 에너지 레벨별 작업 |
| **Mermaid** | 흐름, 프로세스, 피드백 루프 | 입력→처리→출력 |
| **인라인** | 단순 순차 흐름 | `A → B → C` |

**원칙**: 같은 정보를 더 컴팩트하게 표현하는 형식 선택

---

## Critical Rules

### 1. NO Markdown in Labels

**Common Errors**:
```
Node["1. First"]     → "Unsupported markdown: list"
Node["Text<br/>More"] → "Unsupported markdown: heading"
Node["## Header"]    → "Unsupported markdown: heading"
```

**Correct**:
```
Node[First]
Node[Text]
```

**Rule**: Keep labels plain text. Move complex descriptions outside the diagram.

### 2. Prefer Square Layout (정사각형 레이아웃)

**Problem**: `flowchart LR`은 너무 넓고, `flowchart TB`는 너무 길어진다.
Read the full skill on GitHub

Details

Skill name
obsidian-mermaid
Path
obsidian-mermaid/SKILL.md
License
MIT
Repo updated
23 September 2026

FAQ

What does the Obsidian Mermaid skill do?

Create Obsidian-compatible Mermaid diagrams. Prefer square layouts (TB + subgraph LR), avoid markdown in labels. Use when creating flowcharts, sequence diagrams, or any Mermaid diagrams in markdown files.

How do I install the Obsidian Mermaid skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jykim/claude-obsidian-skills --skill obsidian-mermaid. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Obsidian Mermaid popular?

It lives in jykim/claude-obsidian-skills, which has 52 GitHub stars and 10 forks.

Related skills

Ai4pkm Helper

52

jykim/claude-obsidian-skills

AI4PKM helper for orchestrator configuration, worker management, and CLI workflow integration.

Productivity & Notes10

Create Vlog Script

52

jykim/claude-obsidian-skills

Create narration-first personal vlog scripts and slide-based recording guides from rough spoken notes and a supplied media folder. Use for reflective video essays, travel or event vlogs, and video-editing briefs; do not use for producing the final edited video unless requested.

Images, Video & Audio10

Interactive Writing Assistant

52

jykim/claude-obsidian-skills

This skill provides comprehensive support for the writing process from ideation through revision. Use this skill when helping users write essays, articles, or creative pieces through interactive collaboration. The skill supports co-evolving outline and prose, voice-based input processing, multiple writing styles, and connection to the user's PKM system for enriched content.

Writing & Content10

Obsidian YAML Frontmatter

52

jykim/claude-obsidian-skills

Manage YAML frontmatter properties with consistent formatting, property names, and value types. Use when creating or updating frontmatter in markdown files.

Productivity & Notes10

Obsidian Markdown Structure

52

jykim/claude-obsidian-skills

Validate and enforce markdown document structure including frontmatter positioning, heading hierarchy, and content organization. Use when creating or validating markdown files.

Productivity & Notes10

Email

43

analystacademy/claude-skills

Draft emails in the user's voice — direct, human, not generic — based on a voice profile and real samples they fill in below. Use this skill whenever the user asks to write, draft, reply to, or respond to an email; whenever they paste an email and ask how to handle it; and whenever they're working on outbound messages to clients, collaborators, or contacts. Use it even when they don't say "in my voice" — if they're drafting an email, this skill applies.

Productivity & Notes14

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.