> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 화이트보드

> 시각적 사고, 다이어그램 작성, 자유로운 협업을 위한 무한 캔버스 화이트보드를 만드세요.

Craft의 화이트보드는 시각적 사고를 위한 무한 캔버스를 제공합니다. 아이디어를 스케치하거나 다이어그램을 그리고, 프로젝트를 계획하거나 팀과 시각적으로 협업할 때 활용해 보세요.

## 화이트보드란?

화이트보드는 문서에 직접 삽입되는 자유 형식의 캔버스입니다. 구조화된 텍스트와 달리 요소를 원하는 위치에 자유롭게 배치하고, 화살표로 아이디어를 연결하며, 제약 없이 시각적으로 사고할 수 있습니다.

**다음과 같은 작업에 유용합니다:**

* 브레인스토밍 및 마인드맵
* 플로우차트 및 다이어그램 작성
* 시각적 레이아웃으로 프로젝트 계획하기
* 와이어프레임 및 목업 스케치
* 아이디어를 공간적으로 정리하기
* 팀원과의 시각적 협업

## 화이트보드 만들기

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step>
        문서에서 화이트보드를 삽입할 위치에 커서를 둡니다.
      </Step>

      <Step>
        `/whiteboard`를 입력하고 **Return**을 누르거나, **+** 버튼을 클릭한 뒤 **Whiteboard**를 선택합니다.
      </Step>

      <Step>
        새 화이트보드 블록이 나타납니다. 클릭하면 편집 캔버스가 열립니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step>
        문서에서 화이트보드를 삽입할 위치를 탭합니다.
      </Step>

      <Step>
        **+** 버튼을 탭하고 **Whiteboard**를 선택합니다.
      </Step>

      <Step>
        화이트보드 미리보기를 탭하면 편집 캔버스가 열립니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows">
    <Steps>
      <Step>
        문서에서 화이트보드를 삽입할 위치에 커서를 둡니다.
      </Step>

      <Step>
        `/whiteboard`를 입력하고 **Enter**를 누르거나, **+** 버튼을 클릭한 뒤 **Whiteboard**를 선택합니다.
      </Step>

      <Step>
        새 화이트보드 블록이 나타납니다. 클릭하면 편집 캔버스가 열립니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Web">
    <Steps>
      <Step>
        문서에서 화이트보드를 삽입할 위치에 커서를 둡니다.
      </Step>

      <Step>
        `/whiteboard`를 입력하고 **Enter**를 누르거나, **+** 버튼을 클릭한 뒤 **Whiteboard**를 선택합니다.
      </Step>

      <Step>
        새 화이트보드 블록이 나타납니다. 클릭하면 편집 캔버스가 열립니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>

화이트보드가 전체 화면으로 열리면 바로 작업을 시작할 수 있습니다.

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/create-whiteboard.gif?s=866316e819f106de6025a545b9604df6" alt="Creating a whiteboard using the slash command" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/create-whiteboard.gif" />

## 화이트보드 도구

툴바에는 시각적 콘텐츠를 만드는 데 필요한 모든 도구가 준비되어 있습니다.

### 선택 도구

선택 도구로 기존 요소를 이동하고, 크기를 조절하며, 수정할 수 있습니다.

* **요소 선택**: 하나의 요소는 클릭으로, 여러 요소는 드래그로 선택합니다.
* **이동**: 선택한 요소를 드래그하여 위치를 옮깁니다.
* **크기 조절**: 모서리 핸들을 드래그해 크기를 변경합니다.
* **삭제**: 요소를 선택한 뒤 **Delete** 또는 **Backspace**를 누릅니다.

### 그리기 도구

**연필**

연필 도구로 자유롭게 선을 그릴 수 있습니다. 스케치, 손글씨, 유기적인 형태를 만들기에 적합합니다.

* 연필 아이콘을 클릭하거나 **P**를 누릅니다.
* 툴바에서 선 굵기와 색상을 조절합니다.
* 마우스, 트랙패드, 스타일러스로 자연스럽게 그립니다.

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/pencil-drawing.gif?s=c08a462eaa627971a69685d267ba46f8" alt="Freehand drawing with the pencil tool" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/pencil-drawing.gif" />

**화살표**

화살표로 요소를 연결해 관계와 흐름을 표현할 수 있습니다.

* 화살표 아이콘을 클릭하거나 **A**를 누릅니다.
* 시작점에서 끝점까지 드래그합니다.
* 양쪽 끝의 화살촉 스타일을 원하는 대로 설정합니다.
* 선 두께와 색상을 조절합니다.

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/arrows-lines.gif?s=2b5c46723b9cd2139b8d6ceabc356d16" alt="Using arrows and lines to connect elements" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/arrows-lines.gif" />

### 도형 도구

다이어그램이나 구조화된 레이아웃을 만들 때 기하학적 도형을 추가할 수 있습니다.

* **사각형**: 도형 아이콘을 클릭한 뒤 사각형을 선택합니다.
* **마름모**: 도형 아이콘을 클릭한 뒤 마름모를 선택합니다.
* **타원**: 도형 아이콘을 클릭한 뒤 타원을 선택합니다.

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/shapes-tool.gif?s=2ddb0a1082537596975e8819cfa98de0" alt="Using shapes in the whiteboard" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/shapes-tool.gif" />

**도형 사용자 지정:**

* 채우기 색상 및 불투명도
* 선 색상 및 두께
* 도형 내부 텍스트(더블클릭으로 추가)

### 텍스트와 스티키 노트

**텍스트**

캔버스 어디에든 독립적인 텍스트 라벨을 추가할 수 있습니다.

* 텍스트 아이콘을 클릭하거나 **T**를 누릅니다.
* 텍스트를 넣을 위치를 클릭합니다.
* 내용을 입력합니다.
* 글꼴, 크기, 색상 옵션으로 서식을 지정합니다.

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/text-tool.gif?s=263a77c70952bd35fdc13363b9eaa11e" alt="Adding and formatting text in whiteboards" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/text-tool.gif" />

**스티키 노트**

아이디어나 의견을 메모 형태로 남길 수 있습니다.

* 스티키 노트 아이콘을 클릭합니다.
* 노트를 배치할 위치를 클릭합니다.
* 내용을 입력합니다.
* 배경 색상을 선택합니다.

### 이미지 및 미디어

화이트보드에 시각 자료를 바로 추가할 수 있습니다.

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step>
        툴바에서 이미지 아이콘을 클릭합니다.
      </Step>

      <Step>
        기기에서 이미지 파일을 선택합니다.
      </Step>

      <Step>
        이미지가 캔버스에 추가되어 위치와 크기를 조정할 수 있습니다.
      </Step>
    </Steps>

    **제한**: 화이트보드당 최대 이미지 50개, 동영상 10개, 파일당 최대 100MB입니다.
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step>
        툴바에서 이미지 아이콘을 탭합니다.
      </Step>

      <Step>
        사진 또는 파일 앱에서 이미지를 선택합니다.
      </Step>

      <Step>
        이미지가 캔버스에 추가되어 위치와 크기를 조정할 수 있습니다.
      </Step>
    </Steps>

    **제한**: 화이트보드당 최대 이미지 50개, 동영상 10개, 파일당 최대 100MB입니다.
  </Tab>

  <Tab title="Windows">
    <Steps>
      <Step>
        툴바에서 이미지 아이콘을 클릭합니다.
      </Step>

      <Step>
        기기에서 이미지 파일을 선택합니다.
      </Step>

      <Step>
        이미지가 캔버스에 추가되어 위치와 크기를 조정할 수 있습니다.
      </Step>
    </Steps>

    **제한**: 화이트보드당 최대 이미지 50개, 동영상 10개, 파일당 최대 100MB입니다.
  </Tab>

  <Tab title="Web">
    <Steps>
      <Step>
        툴바에서 이미지 아이콘을 클릭합니다.
      </Step>

      <Step>
        기기에서 이미지 파일을 선택합니다.
      </Step>

      <Step>
        이미지가 캔버스에 추가되어 위치와 크기를 조정할 수 있습니다.
      </Step>
    </Steps>

    **제한**: 화이트보드당 최대 이미지 50개, 동영상 10개, 파일당 최대 100MB입니다.
  </Tab>
</Tabs>

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/media-assets.gif?s=d2fe1a8f3299faa21abf318353599c03" alt="Adding images and media to whiteboards" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/media-assets.gif" />

## 탐색 및 보기

### 확대/축소 및 이동

화이트보드 안에서 이동하고 보기 배율을 조정할 수 있습니다.

* **이동**: 두 손가락으로 드래그(트랙패드)하거나, **Space**를 누른 채 드래그(마우스)합니다.
* **확대**: 핀치 아웃(트랙패드), **Cmd/Ctrl** + **+**, 또는 확대/축소 컨트롤을 사용합니다.
* **축소**: 핀치 인(트랙패드), **Cmd/Ctrl** + **-**, 또는 확대/축소 컨트롤을 사용합니다.
* **화면에 맞추기**: 확대/축소 초기화 버튼을 클릭하면 모든 콘텐츠가 한눈에 보입니다.

### 배경 사용자 지정

작업 스타일에 맞게 화이트보드 배경을 바꿀 수 있습니다.

**그리드 옵션:**

* **점**: 은은한 정렬 기준선
* **선**: 전통적인 격자 선
* **사각형**: 모눈 종이 스타일
* **없음**: 깔끔한 빈 캔버스

**배경 색상:**

캔버스 배경 색상을 원하는 대로 선택할 수 있습니다. 배경 색상은 편집 중에도, 문서 미리보기에서도 동일하게 표시됩니다.

<Tabs>
  <Tab title="macOS">
    툴바의 배경 아이콘을 클릭해 배경 설정에 접근합니다. 원하는 그리드 스타일과 색상을 선택하세요.
  </Tab>

  <Tab title="iOS">
    툴바의 배경 아이콘을 탭해 그리드 및 색상 설정을 엽니다.
  </Tab>

  <Tab title="Windows">
    툴바의 배경 아이콘을 클릭해 그리드 스타일과 배경 색상을 선택합니다.
  </Tab>

  <Tab title="Web">
    툴바의 배경 아이콘을 클릭해 그리드 스타일과 배경 색상을 선택합니다.
  </Tab>
</Tabs>

## 화이트보드 편집

### 요소 정렬

요소들이 어떻게 겹치고 연결될지 제어할 수 있습니다.

**레이어 순서:**

* **앞으로 가져오기**: 마우스 오른쪽 버튼 클릭 → **Arrange** → **Bring Forward**
* **뒤로 보내기**: 마우스 오른쪽 버튼 클릭 → **Arrange** → **Send Backward**
* **맨 앞으로 가져오기**: 마우스 오른쪽 버튼 클릭 → **Arrange** → **Bring to Front**
* **맨 뒤로 보내기**: 마우스 오른쪽 버튼 클릭 → **Arrange** → **Send to Back**

**요소 그룹화:**

여러 요소를 선택하고 마우스 오른쪽 버튼을 클릭해 **Group**을 선택하면 하나의 단위로 함께 이동할 수 있습니다. 개별 요소를 다시 편집하려면 그룹을 해제하세요.

### 복사 및 복제

* **복제**: 요소를 선택한 뒤 **Cmd/Ctrl** + **D**를 누릅니다.
* **복사/붙여넣기**: 표준 단축키 **Cmd/Ctrl** + **C**와 **Cmd/Ctrl** + **V**를 사용합니다.
* **잘라내기**: **Cmd/Ctrl** + **X**로 잘라내 클립보드에 저장합니다.

<img src="https://mintcdn.com/craft-support/jHjNTJCRmpMXi5vN/images/write-and-edit/whiteboards/en/content/keyboard-shortcuts.gif?s=3a465b8da0ea34fd07422eea28103dbf" alt="Keyboard shortcuts for working with whiteboards" width="800" height="484" data-path="images/write-and-edit/whiteboards/en/content/keyboard-shortcuts.gif" />

### 콘텐츠 내보내기

화이트보드를 이미지로 내보내서 Craft 외부에서도 활용할 수 있습니다.

<Tabs>
  <Tab title="macOS">
    화이트보드 메뉴에서 **Export**를 선택한 뒤 **PNG** 또는 **SVG** 형식을 고릅니다. 현재 보이는 영역 또는 전체 캔버스를 내보낼 수 있습니다.
  </Tab>

  <Tab title="iOS">
    메뉴 아이콘(•••)을 탭한 뒤 **Export**를 선택합니다. **PNG** 형식을 선택하면 화이트보드를 이미지로 저장할 수 있습니다.
  </Tab>

  <Tab title="Windows">
    Web 및 Windows 앱은 현재 직접 PNG 내보내기를 지원하지 않습니다. 대안으로 화면을 캡처하거나 화이트보드가 포함된 문서를 PDF로 내보내세요.
  </Tab>

  <Tab title="Web">
    Web 및 Windows 앱은 현재 직접 PNG 내보내기를 지원하지 않습니다. 대안으로 화면을 캡처하거나 화이트보드가 포함된 문서를 PDF로 내보내세요.
  </Tab>
</Tabs>

## 협업

화이트보드도 문서와 마찬가지로 실시간 협업을 지원합니다.

여러 명이 같은 화이트보드에서 작업할 때:

* **커서 표시**: 참여자마다 이름과 함께 커서가 표시됩니다.
* **실시간 업데이트**: 변경 사항이 모두에게 즉시 반영됩니다.
* **충돌 없음**: 편집 내용이 자동으로 병합됩니다.

<Info title="화이트보드 공유">
  화이트보드 접근 권한은 문서 권한을 따릅니다. 문서에 편집 권한이 있는 사용자는 화이트보드도 편집할 수 있으며, 뷰어는 화이트보드를 볼 수만 있고 수정할 수는 없습니다.
</Info>

## 화이트보드 미리보기

문서에서는 화이트보드가 캔버스의 스냅샷을 보여주는 미리보기 블록으로 표시됩니다.

**미리보기 업데이트:**

* 화이트보드를 닫으면 자동으로 갱신됩니다.
* 화이트보드의 현재 상태를 보여줍니다.
* 문서의 라이트/다크 모드에 맞춰 적응합니다.

미리보기는 시각적 참고용이며, 클릭하면 전체 화이트보드가 열려 바로 편집할 수 있습니다.

## 팁과 활용 방법

**간단하게 시작하기**

기본 도형과 텍스트로 시작한 뒤, 아이디어가 발전함에 따라 점점 복잡하게 만들어 보세요.

**색상을 의미 있게 활용하기**

카테고리나 주제별로 색상을 지정해 보세요. 일관된 색상 코드는 복잡한 다이어그램도 쉽게 이해할 수 있게 해줍니다.

**화살표 적극 활용하기**

관계, 흐름, 의존성을 화살표로 표현하세요. 화살촉 스타일을 바꿔 다양한 연결 유형을 나타낼 수 있습니다.

**문서와 함께 사용하기**

화이트보드는 텍스트와 함께 사용할 때 가장 효과적입니다. 시각적 사고에는 화이트보드를 활용하고, 결론은 구조화된 텍스트로 정리해 보세요.

**템플릿처럼 재활용하기**

칸반 보드나 플로우차트처럼 자주 쓰는 레이아웃을 만들어 두고, 새 프로젝트마다 복제해 사용하세요.

## 문제 해결

<AccordionGroup>
  <Accordion title="이전 버전 화이트보드 업데이트하기">
    이 섹션에서는 이전 화이트보드 프레임워크로 만들어진 레거시 화이트보드를 업데이트하는 방법을 설명합니다. 이러한 이전 화이트보드는 새 버전의 Craft 앱에서 바로 열 수 없습니다.

    ### 업데이트가 필요한 경우

    문서에 레거시 화이트보드가 포함되어 있다면 보드 미리보기에 **Update Needed** 라벨이 표시됩니다. 화이트보드 블록 자체는 계속 보이고 복제하거나 이동할 수 있지만, 업데이트 전에는 열 수 없습니다.

    ### 업데이트 시작하기

    레거시 화이트보드를 열려고 하면 마이그레이션 대화 상자가 나타납니다. 계속 진행하려면 **Create new version**을 선택하세요. 원본 블록 바로 아래에 새 화이트보드가 생성됩니다.

    ### 마이그레이션 중 일어나는 일

    마이그레이션은 레거시 보드의 모든 항목을 새 프레임워크로 복사합니다. 원본 화이트보드 블록은 그대로 유지되며, 필요하다면 마이그레이션을 다시 실행할 수도 있습니다.

    **현재 제한 사항:**

    * 화이트보드는 원본 버전만 마이그레이션됩니다. 레거시 화이트보드를 복제한 사본은 마이그레이션되지 않습니다.
    * 레이어가 복잡한 일부 레이아웃에서는 텍스트가 일시적으로 도형 뒤에 나타날 수 있습니다. 새 보드에서 레이어 순서를 조정하면 바로잡을 수 있습니다.

    ### 마이그레이션 이후

    새 버전이 만들어지면 평소처럼 열고 편집할 수 있습니다. 결과가 기대와 다르다면 마이그레이션을 다시 실행하거나 내용을 직접 조정할 수 있습니다. 레거시 블록은 삭제하기 전까지 참고용으로 그대로 남아 있습니다.

    <Info title="도움이 필요하신가요?">
      마이그레이션은 콘텐츠를 최대한 정확하게 보존하도록 설계되었습니다. 레이어 순서를 조정하거나 마이그레이션을 반복해도 해결되지 않는 문제가 있다면 지원팀에 문의해 주세요.
    </Info>
  </Accordion>

  <Accordion title="대형 화이트보드의 성능 문제">
    요소가 수백 개에 달하는 매우 큰 화이트보드는 렌더링이 느려질 수 있습니다.

    **성능을 개선하는 방법:**

    * 복잡한 보드를 목적별 섹션으로 나눠 보세요.
    * 주제별로 별도의 화이트보드를 사용하세요.
    * 고해상도 이미지 수를 제한하세요.
    * 작업 중에는 다른 탭과 앱을 닫아 두세요.
  </Accordion>

  <Accordion title="미리보기가 업데이트되지 않음">
    문서의 화이트보드 미리보기에 최근 변경 사항이 반영되지 않는 경우:

    <Steps>
      <Step>
        화이트보드를 엽니다.
      </Step>

      <Step>
        요소를 하나 이동하는 등 작은 변경을 가합니다.
      </Step>

      <Step>
        화이트보드를 닫습니다.
      </Step>
    </Steps>

    이렇게 하면 새 미리보기가 생성되며, 보통 몇 초 안에 업데이트됩니다.
  </Accordion>
</AccordionGroup>

<Info title="도움이 더 필요하신가요?">
  일반적인 문제 해결, 동기화 또는 플랫폼별 문제는 [문제 해결 가이드](/ko/introduction/troubleshooting)를 참고하세요.
</Info>