> ## 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를 사용하면 카메라, 사진 라이브러리, 파일 또는 Unsplash에서 사진, 비디오, 오디오 파일을 삽입할 수 있습니다. 미디어 콘텐츠는 문서에서 아름답게 표시되며, Craft가 자동으로 최적의 레이아웃으로 배치합니다.

<iframe src="https://www.youtube-nocookie.com/embed/3lA7VIjvCis" title="Craft에서 사진, 비디오, 파일 삽입하기" className="w-full aspect-video rounded-xl" allowFullScreen />

## 미디어 삽입하기

슬래시 메뉴, 플러스 버튼을 사용하거나 드래그 앤 드롭으로 문서에 미디어를 추가하세요.

<Tabs>
  <Tab title="macOS">
    `/`를 입력하고 메뉴에서 원하는 미디어 유형을 선택하세요. 폴더나 웹사이트에서 Mac 앱으로 이미지를 드래그 앤 드롭할 수도 있습니다.

    <img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/insert-media-mac.gif?s=e0cf78d06f9bcca8ded646a478c438fe" alt="macOS에서 미디어 삽입하기" width="874" height="1020" data-path="images/write-and-edit/media/en/content/insert-media-mac.gif" />
  </Tab>

  <Tab title="iOS">
    편집 중에 `/`를 입력하고 메뉴에서 원하는 옵션을 선택하세요. 왼쪽 하단의 **+** 버튼을 탭하여 옵션 목록을 볼 수도 있습니다.

    <img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/insert-media-ios.gif?s=4de6608bad409e148a2afd5848ab0d27" alt="iOS에서 미디어 삽입하기" width="406" height="876" data-path="images/write-and-edit/media/en/content/insert-media-ios.gif" />
  </Tab>

  <Tab title="Windows/Web">
    슬래시 기호, 삽입 탭을 사용하거나 미디어 파일을 문서로 드래그 앤 드롭하세요.
  </Tab>
</Tabs>

<Info title="헤더 이미지">
  헤더 이미지의 경우 최적의 표시를 위해 1200 x 630 이미지 크기를 권장합니다.
</Info>

## 이미지

Craft는 이미지의 원본 품질을 보존합니다. 이미지를 미리보기로 열면(탭하거나 더블클릭) 항상 전체 품질로 렌더링되며, Craft에서 이미지를 다운로드할 때도 마찬가지입니다.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/images-layout.png?fit=max&auto=format&n=L5zMoIm2o8A5WVUD&q=85&s=92de87badd580fcd7f79108781cd70ad" alt="이미지 레이아웃 예시" width="1464" height="1358" data-path="images/write-and-edit/media/en/content/images-layout.png" />

### 지원되는 이미지 형식

Craft는 다음을 포함한 모든 표준 이미지 형식을 지원합니다:

* **PNG, JPEG, GIF** – 기존 웹 형식
* **WebP** – 더 나은 압축을 제공하는 최신 웹 형식
* **AVIF** (Advanced Video Image Format) – 뛰어난 압축을 제공하는 차세대 형식
* **SVG** – 벡터 그래픽 (벡터 데이터로 보존되며 첨부 파일 블록으로 표시)
* **HEIC** – iOS 네이티브 형식 (iOS/Mac에서 업로드할 때)

**AVIF의 장점:**

* JPEG 대비 최대 50% 작은 파일 크기
* 작은 파일 크기에서도 더 나은 품질
* 많은 이미지가 있는 문서에 이상적이며 저장 공간 사용량 감소

<Info title="형식 처리">
  Web 또는 Windows 앱을 통해 업로드된 **.webp** 및 **.heic** 이미지는 첨부 파일 블록으로 나타날 수 있습니다. 모든 플랫폼에서 최상의 호환성을 위해 PNG 또는 JPEG 형식을 사용하세요.
</Info>

### 자동 레이아웃

Craft는 비슷한 크기의 이미지를 나란히 배치할 때 직관적으로 함께 배열합니다. 문서의 썸네일은 앱 성능을 보존하기 위해 해상도가 낮을 수 있지만, 원본 품질은 항상 유지됩니다.

### 이미지 재배열

자동으로 그룹화된 이미지를 재배열하려면:

* 문서의 다른 블록으로 이동
* **...** 메뉴에서 "이미지 크기" 설정을 "자동"에서 "크게"로 변경

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/rearrange-images.gif?s=90e2d9d943add806656a6752a202e524" alt="이미지 재배열" width="800" height="662" data-path="images/write-and-edit/media/en/content/rearrange-images.gif" />

<Warning title="이미지 편집">
  현재 Craft 내에서 업로드된 이미지를 자르거나 편집하는 것은 불가능합니다.
</Warning>

### 갤러리 보기

이미지를 더블클릭(터치 기기에서는 탭)하면 갤러리 뷰어에서 열립니다. 뷰어는 앱 창(또는 브라우저 탭) 전체를 채우며 문서의 모든 이미지가 포함되어 있어, 페이지를 스크롤하지 않고도 이미지를 하나씩 넘겨볼 수 있습니다. 하위 페이지에 있는 이미지는 포함되지 않습니다.

<img src="https://mintcdn.com/craft-support/nYEIz2ZOY7_nvPOY/images/write-and-edit/media/en/content/gallery-view.png?fit=max&auto=format&n=nYEIz2ZOY7_nvPOY&q=85&s=346c72d91392b6047ed77bd454e15023" alt="갤러리 보기" width="1452" height="966" data-path="images/write-and-edit/media/en/content/gallery-view.png" />

뷰어 하단의 화살표와 카운터로 이미지를 앞뒤로 넘길 수 있으며, 현재 보고 있는 이미지를 기기에 다운로드할 수도 있습니다.

macOS에서는 뷰어에 편집 옵션도 있어 이미지를 미리보기에서 열어 마크업하거나 조정할 수 있습니다. 변경 사항을 저장하면 편집된 버전이 다시 Craft에 업로드됩니다.

<Warning title="편집하면 원본이 대체됩니다">
  편집한 이미지를 저장하면 문서의 원본 이미지를 덮어쓰며, 이 작업은 취소할 수 없습니다. 편집하지 않은 버전을 유지하려면 먼저 이미지를 복제하세요.
</Warning>

## 비디오

Craft는 비디오 파일을 변환하거나 압축하지 않으며 원본 품질이 보존됩니다. 모든 비디오 형식을 Craft 문서에 업로드할 수 있습니다.

### 비디오 형식

* **지원되는 미리보기**: *.mp4* 및 *.mov* 파일은 썸네일 미리보기를 표시합니다
* **첨부 파일 블록**: *.avi*, *.wmv* 및 기타 일반적이지 않은 형식은 표준 첨부 파일 블록으로 표시됩니다

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/video-preview.png?fit=max&auto=format&n=L5zMoIm2o8A5WVUD&q=85&s=2b77eef6513099166b3b5a61cabeb937" alt="비디오 형식 미리보기" width="753" height="1054" data-path="images/write-and-edit/media/en/content/video-preview.png" />

### 비디오 재생

썸네일 미리보기가 있는 비디오는 Craft 내의 별도 플레이어에서 열립니다. 첨부 파일 블록으로 표시되는 비디오는 먼저 다운로드한 후 호환되는 프로그램으로 재생해야 합니다.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/video-player.gif?s=467f825da8b2523f052fcfa64f0e297b" alt="비디오 플레이어" width="800" height="756" data-path="images/write-and-edit/media/en/content/video-player.gif" />

<Warning title="참고">
  Craft는 아직 YouTube나 Vimeo와 같은 외부 플랫폼의 비디오 임베드 기능을 제공하지 않습니다.
</Warning>

## 오디오 파일

오디오 파일은 문서에서 표준 첨부 파일 블록으로 표시됩니다. 오디오 파일을 클릭하거나 탭하면 별도의 플레이어 창에서 열립니다.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/audio-block.png?fit=max&auto=format&n=L5zMoIm2o8A5WVUD&q=85&s=df9b04b2406f90713db584ad3d04c5be" alt="오디오 파일 블록" width="744" height="505" data-path="images/write-and-edit/media/en/content/audio-block.png" />

오디오 플레이어는 오디오 콘텐츠에 대한 재생 컨트롤을 제공합니다.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/audio-player.gif?s=6234066e3c8b10cd67e7ce59b415f0db" alt="오디오 플레이어 인터페이스" width="748" height="522" data-path="images/write-and-edit/media/en/content/audio-player.gif" />

## Unsplash 통합

Craft는 Unsplash와 통합되어 수백만 장의 고품질 무료 사진에 액세스할 수 있습니다. 이미지를 삽입할 때 Unsplash 옵션을 선택하여 Craft 내에서 직접 전문 사진을 탐색하고 검색하세요.

다음과 같은 용도로 특히 유용합니다:

* 헤더 이미지
* 시각적 영감
* 전문적인 문서
* 프레젠테이션 및 게시된 페이지

## Image Playground

Apple Intelligence가 있는 기기(iOS 18.2+, macOS 15.2+)에서는 Image Playground를 사용하여 Craft에서 직접 맞춤형 이미지를 생성할 수 있습니다. 애니메이션, 일러스트레이션 또는 스케치 스타일로 텍스트 설명에서 AI 생성 이미지를 만들어 보세요 - 시각적 브레인스토밍, 플레이스홀더 이미지, 창의적 프로젝트에 완벽합니다.

[Image Playground에 대해 자세히 알아보기](/ko/write-and-edit/image-playground)