새 탭에서 열립니다

Sharp Diagrams: Confluence 및 Jira용 Mermaid 다이어그램

다이어그램을 텍스트로 작성하면 Confluence 페이지와 Jira 이슈에 선명하고 확대할 수 있는 그림으로 표시됩니다. 제품마다 하나씩 두 개의 앱이 Atlassian Marketplace에 출시될 예정입니다.

문서 읽기(영문)지원(영문)Sharp Diagrams가 Confluence 페이지에 그린 Mermaid 순서도

Sharp Diagrams란?

Sharp Diagrams는 텍스트로 Mermaid 다이어그램을 그립니다. Confluence에서는 페이지의 매크로로, Jira에서는 이슈의 패널에 표시됩니다. Mermaid는 순서도, 시퀀스 다이어그램, 간트 차트 등 여러 다이어그램을 작성하는 텍스트 형식입니다.

같은 다이어그램 엔진을 쓰는 앱이 두 개 있습니다. Sharp Diagrams – Mermaid for Confluence는 편집기와 실시간 미리 보기가 있는 다이어그램 매크로를 추가합니다. Sharp Diagrams – Mermaid for Jira는 이슈 설명의 mermaid 코드 블록을 패널에 그립니다. 사용하는 제품용 앱을 설치하거나 둘 다 설치하세요.

데이터는 Atlassian 밖으로 나가지 않습니다. 앱은 Atlassian의 Forge 플랫폼에서 실행되고, 외부 연결이 없으며, 자체적으로 아무것도 저장하지 않습니다. 다이어그램 코드는 Confluence 페이지나 Jira 이슈에 그대로 남습니다.

Confluence와 Jira에 Mermaid 다이어그램은 어떻게 추가하나요?

모든 다이어그램 유형과 작성법은 Mermaid 공식 문서에 나와 있습니다: mermaid.js.org(영문).

Confluence

  1. 페이지를 편집하고 /mermaid를 입력한 다음 Mermaid diagram을 선택합니다.
  2. 왼쪽에 Mermaid 코드를 작성하거나 Start from에서 템플릿을 선택합니다.
  3. 입력하는 동안 오른쪽 미리 보기가 업데이트됩니다. 코드에 오류가 있으면 오류 메시지와 줄 번호가 코드 아래에 표시됩니다.
  4. Save를 선택하고 페이지를 게시합니다. 나중에 다이어그램을 변경하려면 페이지를 편집하고 다이어그램을 선택한 다음 편집(연필) 버튼을 누릅니다.

Jira

  1. 이슈 설명에 코드 블록을 추가하고 언어를 mermaid로 설정한 다음 블록에 다이어그램 코드를 작성합니다.
  2. 이슈를 열고 이슈 제목 아래의 앱 버튼에서 Mermaid diagrams를 선택합니다. 그 후에는 패널이 이슈에 계속 표시됩니다.
  3. 설명의 mermaid 코드 블록마다 패널에 별도의 다이어그램이 그려집니다. 설명을 변경한 후에는 이슈를 다시 불러와야 새 다이어그램이 보입니다.

기능

입력하는 동안 실시간 미리 보기

왼쪽에 Mermaid 코드를 작성하면 오른쪽에 다이어그램이 표시됩니다. 오류가 있으면 메시지와 줄 번호가 표시되고, 마지막으로 정상 작동한 다이어그램이 계속 보입니다.

11가지 다이어그램 유형의 템플릿

순서도, 시퀀스, 클래스, 상태, ER, 간트 다이어그램, 마인드맵, 타임라인, 파이 차트, 사용자 여정, Git 그래프. 템플릿이 직접 작성한 코드를 대체하기 전에 편집기가 확인합니다.

알맞은 크기의 선명한 다이어그램

다이어그램은 페이지나 패널 너비에 맞춰 SVG로 그려지며 확대해도 선명합니다. 아주 넓은 다이어그램은 텍스트를 읽을 수 있도록 75 %까지만 축소됩니다.

확대, 다운로드, 복사

50 %에서 300 %까지 확대하고 다이어그램을 다시 너비에 맞출 수 있습니다. SVG로 다운로드하거나 슬라이드와 문서용으로 두 배 크기의 PNG로 다운로드하고, 코드를 복사할 수도 있습니다.

Jira 이슈 설명의 다이어그램

설명의 mermaid 코드 블록마다 별도의 다이어그램이 되므로, 한 이슈에 예를 들어 순서도와 시퀀스 다이어그램을 함께 둘 수 있습니다. 다른 코드 블록은 그대로 둡니다.

라이트 모드와 다크 모드

다이어그램은 Confluence와 Jira의 색상 모드를 따릅니다. 다크 모드에서는 Mermaid의 어두운 테마로 그려집니다.

PDF 및 Word 내보내기

Confluence는 내보내기를 서버에서 만드는데, 서버에서는 다이어그램을 그릴 수 없어 내보낸 파일에는 다이어그램 코드가 들어갑니다. 문서에 그림을 넣으려면 PNG나 SVG로 다운로드하세요.

데이터는 Atlassian 안에

외부 연결도, 자체 저장소도 없습니다. Jira에서 패널은 이슈를 보는 사람의 권한으로 설명을 읽으므로, 그 사람이 이미 볼 수 있는 내용만 보여 줍니다.

가격

사용자 최대 10명

무료.

사용자 100명

연 250달러(USD).

가격은 앱마다 따로 적용됩니다. 청구는 Atlassian이 처리합니다. 다른 사용자 수 구간의 가격은 앱이 출시되면 Atlassian Marketplace에 표시됩니다. 무료 플랜 고객도 유료 고객과 동일한 지원을 받습니다.

스크린샷

Confluence의 다이어그램 편집기: 왼쪽에 Mermaid 코드, 오른쪽에 실시간 미리 보기확대, 다운로드, 코드 복사 도구 모음이 있는 Confluence 페이지의 순서도다이어그램 편집기에서 선택한 간트 템플릿Jira 이슈 설명의 mermaid 코드 블록과 Mermaid diagrams 패널에 그려진 다이어그램Jira 패널의 도구 모음과 125 %로 확대한 다이어그램Jira 이슈 설명 하나에서 그린 두 다이어그램: 시퀀스 다이어그램과 상태 다이어그램

자주 묻는 질문

Sharp Diagrams는 얼마인가요?
사용자 10명까지는 무료입니다. 사용자 100명은 연 250달러(USD)입니다. 가격은 앱마다 따로 적용되며, 청구는 Atlassian이 처리합니다.

두 앱이 모두 필요한가요?
아니요. Confluence 앱은 Confluence 페이지에 다이어그램을 그리고, Jira 앱은 Jira 이슈 설명에서 다이어그램을 그립니다. 사용하는 제품용 앱을 설치하거나 둘 다 설치하세요.

Sharp Diagrams는 어떤 다이어그램 유형을 지원하나요?
Mermaid의 다이어그램 유형을 지원합니다. 예를 들어 순서도, 시퀀스, 클래스, 상태, ER, 간트 다이어그램, 마인드맵, 타임라인, 파이 차트, 사용자 여정, Git 그래프가 있습니다. Confluence 편집기에는 이 11가지 유형의 템플릿이 있습니다.

Jira 이슈에 다이어그램은 어떻게 추가하나요?
이슈 설명에 언어가 mermaid인 코드 블록을 추가하고 이슈에서 Mermaid diagrams 패널을 엽니다. mermaid 코드 블록마다 별도의 다이어그램이 됩니다. 설명을 변경한 후에는 이슈를 다시 불러와야 새 다이어그램이 보입니다.

PDF 및 Word로 내보내면 다이어그램이 포함되나요?
내보낸 파일에는 다이어그램 코드가 코드 블록으로 들어가며, 그림은 페이지에 있다는 안내가 함께 표시됩니다. Confluence는 내보내기를 서버에서 만들고, 서버에서는 다이어그램을 그릴 수 없습니다. 문서에 그림을 넣으려면 PNG나 SVG로 다운로드하세요.

데이터가 Atlassian 밖으로 나가나요?
아니요. 앱은 Atlassian의 Forge 플랫폼에서 실행되며 외부 연결이 없습니다. 자체적으로 아무것도 저장하지 않으며, 다이어그램 코드는 Confluence 페이지나 Jira 이슈에 그대로 남습니다.

다이어그램 안의 링크와 HTML이 실행되나요?
아니요. 다이어그램은 보는 사람의 브라우저에서 Mermaid의 엄격한 보안 수준(strict)으로 그려지므로, 다이어그램 안의 링크, 클릭 핸들러, HTML은 실행되지 않습니다.

라이선스가 활성 상태가 아니면 어떻게 되나요?
다이어그램이 그려지지 않고 대신 코드가 표시되므로 내용은 사라지지 않습니다.

지원 및 약관

지원: support@hdsoft.fi, 핀란드 시간 기준 월요일~금요일 9:00–17:00, 영어와 핀란드어로 지원합니다. 응답 시간과 보안 신고는 지원 페이지(영문)에 나와 있습니다.

문서: Sharp Diagrams 설정 및 사용 방법(영문).

개인정보: 개인정보 처리방침(영문).

약관 및 다른 앱: Jira 및 Confluence용 앱.

Atlassian Marketplace 출시 예정

Sharp Diagrams는 Atlassian Marketplace를 통해 Confluence Cloud와 Jira Cloud에 출시될 예정입니다. 작동 방식은 지금 문서에서 확인할 수 있습니다.

문서 읽기(영문)

Atlassian, Jira, Confluence는 Atlassian의 상표입니다. 앱은 HD SofT가 만들고 지원합니다.