Mermaid ASCII
lastmod 2026-11-16created 2026-01-315 edits
beautiful-mermaid는 Mermaid 다이어그램 코드를 SVG 나 터미널용 ASCII·Unicode 텍스트로 그려 주는 TypeScript 라이브러리이다. Craft 가 자사 코딩 에이전트 앱 Craft Agents 의 다이어그램 표시용으로 만들었다. 기본 Mermaid 렌더러는 터미널 출력이 없고 의존성이 무겁다는 점을 이유로 들며, ASCII 렌더링 엔진은 Alexander Grooff 의 Go 프로젝트 mermaid-ascii 를 TypeScript 로 옮겨 확장한 것이다.
About
- Flowchart, State, Sequence, Class, ER, XY Chart(막대·꺾은선) 6종 다이어그램
-
renderMermaidSVG()는 동기 함수라 ReactuseMemo()안에서 바로 씀. 레이아웃은 ELK.js -
renderMermaidASCII()는 기본으로 Unicode 박스 문자를 쓰고useAscii: true면+ - |만 씀. 노드 간격과 ANSI·truecolor 색 모드 옵션 있음 - 배경·전경 두 색만 주면 나머지 색은 CSS
color-mix()로 만드는 Mono 모드. 색은 SVG 의 CSS 변수라 다시 그리지 않고 테마를 바꿈 - 내장 테마 15개, Shiki 를 거쳐 VS Code 테마를 그대로 가져옴
- DOM 의존성이 없음. README 기준 다이어그램 100개 이상을 500ms 안에 그림
- MIT 라이선스
See also
- Mermaid
- ASCII
- MonoSketch - ASCII 기반 다이어그램 제작 도구