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.
Install
npx skills add jykim/claude-obsidian-skills --skill obsidian-mermaidgit 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-mermaidPersonal 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`는 너무 길어진다.Details
- Skill name
obsidian-mermaid- Repository
- jykim/claude-obsidian-skills
- 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
52jykim/claude-obsidian-skills
AI4PKM helper for orchestrator configuration, worker management, and CLI workflow integration.
Create Vlog Script
52jykim/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.
Interactive Writing Assistant
52jykim/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.
Obsidian YAML Frontmatter
52jykim/claude-obsidian-skills
Manage YAML frontmatter properties with consistent formatting, property names, and value types. Use when creating or updating frontmatter in markdown files.
Obsidian Markdown Structure
52jykim/claude-obsidian-skills
Validate and enforce markdown document structure including frontmatter positioning, heading hierarchy, and content organization. Use when creating or validating markdown files.
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.
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.