SuitsDocs
콘텐츠블록

미디어 블록

이미지, 동영상 등 미디어 콘텐츠를 삽입하세요.

이미지 블록

이미지를 페이지에 삽입합니다.

생성 방법

방법설명
슬래시 명령어/image
붙여넣기스크린샷 또는 이미지 Cmd/Ctrl + V
드래그 앤 드롭파일을 페이지로 드래그

이미지 업로드 방법

1. 파일 업로드

  • 블록 클릭 → 파일 업로드 버튼
  • 또는 파일을 블록으로 드래그

2. 클립보드에서 붙여넣기

  • 스크린샷 캡처 후 Cmd/Ctrl + V
  • 다른 앱에서 복사한 이미지 붙여넣기

3. URL로 삽입

  • 링크로 추가 클릭
  • 이미지 URL 입력

지원 형식

형식확장자
JPEG.jpg, .jpeg
PNG.png
GIF.gif (애니메이션 지원)
WebP.webp
SVG.svg

이미지 설정

설정설명
크기 조절모서리를 드래그하여 크기 변경
정렬왼쪽 / 가운데 / 오른쪽
캡션이미지 아래에 설명 텍스트 추가
Alt 텍스트접근성을 위한 대체 텍스트
링크이미지 클릭 시 URL로 이동

크기 조절

  • 마우스 드래그: 모서리를 드래그하여 크기 변경
  • 전체 너비: 페이지 너비에 맞춤
  • 원본 크기: 업로드된 원본 크기로 표시

갤러리 레이아웃

여러 이미지를 나란히 배치하려면 컬럼 블록을 사용하세요.

┌─────────────┬─────────────┬─────────────┐
│   이미지1   │   이미지2   │   이미지3   │
└─────────────┴─────────────┴─────────────┘

이미지를 선택하고 캡션을 추가하면 문서의 전문성이 높아집니다. "그림 1: 시스템 아키텍처"처럼 캡션을 작성하세요.


YouTube 블록

YouTube 동영상을 전용 블록으로 삽입합니다.

생성 방법

방법설명
슬래시 명령어/youtube

지원 URL 형식

https://youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://youtube.com/embed/VIDEO_ID

YouTube 설정

설정설명
컨트롤 표시재생 컨트롤 표시 (기본 활성화)
개인정보 보호 모드YouTube nocookie 도메인 사용 (기본 활성화)

동영상은 현재 YouTube 블록을 통해 삽입합니다. 별도의 동영상 업로드 블록(/video)이나 파일 블록(/file), 오디오 블록(/audio)은 아직 슬래시 명령어로 제공되지 않습니다. 데이터 타입으로는 VIDEO가 정의되어 있으나, 에디터 UI에서의 직접 생성은 YouTube 블록을 사용해 주세요.


미디어 관리 팁

1. 파일 크기 최적화

큰 이미지는 업로드 전 압축하세요. 일반적으로:

  • 웹용 이미지: 1-2MB 이하 권장
  • 스크린샷: PNG보다 JPEG가 작음
  • 동영상: YouTube/Vimeo 사용 권장

2. 접근성 고려

  • 이미지에 Alt 텍스트 추가
  • 동영상에 자막 또는 캡션 제공
  • 오디오에 텍스트 변환 첨부

3. 구조화된 미디어 사용

관련 미디어는 컬럼 또는 갤러리로 그룹화하세요.

4. 네이밍 규칙

파일명을 의미 있게 지정하세요.

❌ IMG_20240115.jpg
✅ 시스템-아키텍처-v2.jpg

❌ 녹음.mp3
✅ 2024-01-15-주간회의-녹음.mp3

다음 단계