> ## 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.

# 토글

> 토글을 사용해 내용 블록을 접고 펼치는 방법을 배우세요. 문서를 깔끔하고 정돈되게 유지할 수 있습니다.

토글은 문서에서 내용을 숨기거나 표시할 수 있는 강력한 방법입니다. 활성 작업 중이 아닌 섹션을 접어두어 작업 공간을 깔끔하고 집중된 상태로 유지하는 데 도움이 됩니다.

<iframe src="https://www.youtube-nocookie.com/embed/t7bow8G1sNE" title="Craft Toggles Tutorial" className="w-full aspect-video rounded-xl" allowFullScreen />

## 토글이란?

토글은 중첩된 내용을 숨기거나 표시할 수 있는 접이식 블록입니다. 아코디언이나 드롭다운 섹션처럼 생각하세요 – 클릭하여 내부를 보고, 공간을 절약하려면 접어둘 수 있습니다.

토글은 다음 용도에 적합합니다:

* 항상 필요하지 않은 자세한 정보를 숨기기
* FAQ 스타일의 문서 만들기
* 참고 자료는 접근 가능하게 유지하되 방해되지 않게 숨기기
* 섹션이 많은 긴 문서 관리하기
* 더 깔끔한 프레젠테이션 및 공유 문서 만들기

## 토글 만들기

Craft에서 토글을 만드는 방법은 여러 가지가 있습니다:

### 슬래시 메뉴 사용하기

<Steps>
  <Step>
    슬래시 메뉴를 열려면 `/`를 입력하세요
  </Step>

  <Step>
    검색창에 "toggle"을 입력하거나 스크롤해서 찾으세요
  </Step>

  <Step>
    메뉴에서 "토글"을 선택하세요
  </Step>

  <Step>
    항상 보이는 부분인 토글 제목을 입력하세요
  </Step>

  <Step>
    토글 내부에 내용을 만들려면 Enter 키를 누르세요
  </Step>
</Steps>

### 마크다운 단축키 사용하기

키보드에서 손을 떼지 않고 작업하고 싶다면 입력하는 중에 블록을 토글로 변환할 수 있습니다:

<Steps>
  <Step>
    빈 블록의 시작 부분에 커서를 놓으세요
  </Step>

  <Step>
    더하기 기호(`+`)를 입력한 후 스페이스를 누르세요
  </Step>
</Steps>

블록이 즉시 토글로 바뀌고 `+ ` 문자는 제거됩니다. 토글 제목을 입력한 후 Enter 키를 눌러 내부에 내용을 추가하세요.

<Tip>
  이는 Craft에서 다른 블록에 사용하는 단축키 방식과 동일합니다. 예를 들어 `-`와 스페이스로 글머리 기호 목록을, `1.`과 스페이스로 번호 매기기 목록을 만들 수 있습니다.
</Tip>

### 기존 내용을 토글로 변환하기

중첩된 내용이 있는 블록은 토글로 전환할 수 있습니다:

<Steps>
  <Step>
    중첩된 내용이 포함된 블록을 클릭하세요
  </Step>

  <Step>
    오른쪽 클릭하거나 블록 메뉴를 사용하세요
  </Step>

  <Step>
    "토글로 변환"을 선택하세요
  </Step>
</Steps>

블록은 기본적으로 중첩된 내용이 숨겨진 토글로 바뀝니다.

## 토글 펼치기와 접기

**토글을 펼치려면**: 토글 제목 옆의 화살표 아이콘(▶)을 클릭하세요. 화살표가 아래로 회전(▼)하고 내용이 표시됩니다.

**토글을 접으려면**: 내용을 숨기려면 화살표 아이콘을 다시 클릭하세요.

<Info title="키보드 단축키">
  * 현재 블록을 토글로 전환: `Cmd+Option+7` (macOS) 또는 `Ctrl+Shift+7` (Windows)
  * 문서의 모든 토글을 한 번에 펼치거나 접기: `Cmd+Option+T` (macOS) 또는 `Ctrl+Alt+T` (Windows)
</Info>

## 중첩 토글 사용하기

토글 안에 다른 토글을 넣어 여러 단계의 접이식 콘텐츠를 만들 수 있습니다. 이는 계층적 정보 구조를 만들 때 유용합니다:

```
▶ Project Overview
  ▶ Phase 1: Planning
    - Requirements gathering
    - Stakeholder meetings
  ▶ Phase 2: Development
    - Sprint 1
    - Sprint 2
```

각 토글 레벨은 독립적으로 펼치거나 접을 수 있습니다.

## 토글 사용 팁 및 모범 사례

* **설명적인 제목 사용**: 제목만 항상 보이므로 내부에 무엇이 있는지 분명하게 표시하세요.
* **과도 사용 금지**: 토글이 너무 많으면 문서가 미로처럼 느껴질 수 있습니다. 진짜 선택적 콘텐츠에만 사용하세요.
* **공유 시 보이는 내용을 고려하세요**: 중요한 정보는 추가 클릭 없이 바로 읽을 수 있어야 합니다.
* **다른 기능과 결합하기**: 토글은 카드, 목록, 헤더와 함께 사용하면 문서 구조를 잡는 데 효과적입니다.

## 일반 블록으로 다시 변환하기

더 이상 토글을 사용하지 않으려면:

<Steps>
  <Step>
    내용을 볼 수 있도록 토글을 펼치세요
  </Step>

  <Step>
    토글 블록에서 오른쪽 클릭하세요
  </Step>

  <Step>
    "일반 블록으로 변환"을 선택하세요(또는 그룹 해제를 사용하세요)
  </Step>
</Steps>

내용은 그대로 남아 항상 표시됩니다.

## 토글을 사용할 때

같은 화면에서 내용을 숨기되 빠르게 접근할 수 있어야 할 때 토글을 사용하세요. 선택적이거나 참고용 자료, FAQ 답변, 보조 세부사항이 그 예입니다. 자주 쓰이는 패턴 몇 가지를 소개합니다:

* **회의 노트**: 주요 안건은 항상 표시, 토론 내용은 토글에 숨기기
* **프로젝트 문서**: 개요는 항상 표시, 기술적 세부사항은 토글에 보관
* **학습 자료**: 질문은 보이게 하고, 정답은 필요할 때까지 토글에 숨기기

콘텐츠가 별도의 전용 공간을 가질 필요가 있을 때, 독립적이고 방대한 내용일 때, 또는 더 깊은 계층적 구조에 속할 때는 페이지를 사용하세요.

<CardGroup cols={2}>
  <Card title="블록 및 페이지" href="/ko/write-and-edit/blocks-and-pages">
    Craft의 구조 이해
  </Card>

  <Card title="문서 스타일링" href="/ko/write-and-edit/styling">
    콘텐츠의 형식 및 스타일 지정
  </Card>

  <Card title="컬렉션" href="/ko/organize-and-find/collections">
    구조화된 데이터를 위한 데이터베이스 유사 기능
  </Card>
</CardGroup>