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: 시스템 아키텍처"처럼 캡션을 작성하세요.


동영상 블록

동영상을 페이지에 삽입합니다.

생성 방법

방법설명
슬래시 명령어/video
URL 붙여넣기YouTube/Vimeo URL 붙여넣기

동영상 종류

외부 동영상 (URL)

지원되는 플랫폼의 URL을 입력하면 자동으로 임베드됩니다.

업로드 동영상

직접 동영상 파일을 업로드할 수 있습니다.

형식확장자
MP4.mp4
WebM.webm
MOV.mov

업로드 동영상은 파일 용량 제한이 있습니다. 긴 동영상은 YouTube나 Vimeo에 업로드 후 URL로 삽입하는 것을 권장합니다.

동영상 설정

설정설명
크기너비 조절
자동 재생페이지 로드 시 자동 재생 (음소거)
컨트롤 표시재생 컨트롤 표시 여부
캡션동영상 설명 텍스트

YouTube 블록

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

생성 방법

방법설명
슬래시 명령어/youtube
URL 붙여넣기YouTube URL 자동 변환

지원 URL 형식

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

YouTube 설정

설정설명
시작 시간특정 시점부터 재생
종료 시간특정 시점에서 종료
자동 재생페이지 로드 시 자동 재생
반복 재생영상 반복

파일 블록

다양한 형식의 파일을 첨부합니다.

생성 방법

방법설명
슬래시 명령어/file
드래그 앤 드롭파일을 페이지로 드래그

지원 형식

문서

형식확장자
PDF.pdf
Word.doc, .docx
Excel.xls, .xlsx
PowerPoint.ppt, .pptx
텍스트.txt, .rtf

압축 파일

형식확장자
ZIP.zip
RAR.rar
7Z.7z

기타

사실상 모든 파일 형식을 첨부할 수 있습니다.

파일 표시 옵션

옵션설명
링크파일명과 다운로드 아이콘으로 표시
인라인 미리보기PDF 등 미리보기 가능한 형식은 페이지 내에서 표시

PDF 인라인 미리보기

PDF 파일은 페이지 내에서 직접 볼 수 있습니다.

┌─────────────────────────────────────────┐
│  📄 보고서.pdf                    [↓]  │
├─────────────────────────────────────────┤
│  ┌───────────────────────────────────┐  │
│  │                                   │  │
│  │         PDF 미리보기             │  │
│  │                                   │  │
│  │                                   │  │
│  └───────────────────────────────────┘  │
│              1 / 10                     │
└─────────────────────────────────────────┘

오디오 블록

음성 파일이나 음악을 삽입합니다.

생성 방법

방법설명
슬래시 명령어/audio
드래그 앤 드롭오디오 파일을 페이지로 드래그

지원 형식

형식확장자
MP3.mp3
WAV.wav
OGG.ogg
M4A.m4a

오디오 플레이어

인라인 오디오 플레이어로 재생됩니다.

┌─────────────────────────────────────────┐
│  🎵 회의 녹음.mp3                       │
│  ▶ ━━━━━━━━━━━━━━━━━━━━━ 12:34 / 45:00  │
└─────────────────────────────────────────┘

미디어 관리 팁

1. 파일 크기 최적화

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

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

2. 접근성 고려

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

3. 구조화된 미디어 사용

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

4. 네이밍 규칙

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

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

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

다음 단계