콘텐츠로 이동
Search

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() 는 동기 함수라 React useMemo() 안에서 바로 씀. 레이아웃은 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

Favorite site

author Zer0, MCPBot sitemap