블록 | Suits Docs

블록 시스템 개요

슈츠는 21가지 이상의 블록 타입을 제공하며, 크게 4가지 카테고리로 분류됩니다.

카테고리	블록 수	용도
텍스트 블록	10개	문서 작성, 리스트, 인용
미디어 블록	4개	이미지, 동영상, 파일
데이터 블록	4개	데이터모델, 차트, 통계
레이아웃/임베드 블록	5개	컬럼, 탭, 외부 콘텐츠

블록 추가하기

페이지 내에서 블록을 추가하는 방법은 여러 가지입니다.

슬래시 명령어 (/)

가장 빠른 방법입니다. 빈 줄에서 /를 입력하면 블록 메뉴가 나타납니다.

/h1        → 제목 1
/bullet    → 불릿 리스트
/todo      → 할 일 목록
/image     → 이미지
/datamodel → 데이터모델
/code      → 코드 블록

블록 이름 일부만 입력해도 검색됩니다. /dat만 입력해도 datamodel이 검색됩니다.

더하기 버튼 (+)

줄 왼쪽에 마우스를 올리면 나타나는 + 버튼을 클릭합니다.

드래그 앤 드롭

파일을 페이지로 드래그하면 자동으로 적절한 블록이 생성됩니다
이미지 → 이미지 블록
PDF/문서 → 파일 블록
동영상 → 비디오 블록

붙여넣기

클립보드의 콘텐츠를 붙여넣으면 자동으로 변환됩니다.

스크린샷 → 이미지 블록
URL → 북마크 또는 임베드 블록
코드 → 코드 블록

블록 조작

선택

클릭하여 단일 블록 선택
Shift + 클릭으로 범위 선택
Cmd/Ctrl + A로 전체 선택

이동

블록 왼쪽의 드래그 핸들(⋮⋮)을 잡고 원하는 위치로 드래그합니다.

복제

선택 후 Cmd/Ctrl + D
또는 블록 메뉴에서 복제 선택

삭제

선택 후 Backspace 또는 Delete
또는 블록 메뉴에서 삭제 선택

블록 타입 변환

일부 블록은 다른 타입으로 변환할 수 있습니다.

블록 선택
왼쪽 드래그 핸들 클릭 또는 / 입력
변환할 블록 타입 선택

텍스트 → 제목, 불릿 리스트, 번호 리스트, 할 일
제목 → 텍스트, 다른 레벨 제목

블록 카테고리

텍스트 블록

문서 작성을 위한 기본 블록들입니다.

블록	슬래시 명령어	마크다운	설명
텍스트	`/text`	-	일반 단락
제목 1	`/h1`, `/heading1`	`#`	가장 큰 제목
제목 2	`/h2`, `/heading2`	`##`	중간 제목
제목 3	`/h3`, `/heading3`	`###`	작은 제목
불릿 리스트	`/bullet`	`-`	순서 없는 목록
번호 리스트	`/numbered`	`1.`	순서 있는 목록
할 일 목록	`/todo`	`[]`	체크박스 목록
인용문	`/quote`	`>`	인용 블록
콜아웃	`/callout`	-	강조 박스
구분선	`/divider`	`---`	수평 구분선

👉 텍스트 블록 자세히 보기

미디어 블록

시각적 콘텐츠를 위한 블록들입니다.

블록	슬래시 명령어	설명
이미지	`/image`	이미지 파일 또는 URL
동영상	`/video`	업로드 또는 YouTube/Vimeo
파일	`/file`	문서, 압축파일 등 첨부
오디오	`/audio`	음성/음악 파일

👉 미디어 블록 자세히 보기

데이터 블록

구조화된 데이터를 표시하는 블록들입니다.

블록	슬래시 명령어	설명
데이터모델	`/datamodel`	데이터모델 뷰 삽입
통계 블록	`/stat`	SQL 쿼리 결과 시각화
선택 처리	`/selectprocess`	항목 선택 후 일괄 처리
테이블	`/table`	간단한 정적 테이블
수식	`/math`	LaTeX 수학 공식

👉 데이터 블록 자세히 보기 👉 선택 처리 블록 자세히 보기

레이아웃/임베드 블록

페이지 구조와 외부 콘텐츠를 위한 블록들입니다.

블록	슬래시 명령어	설명
컬럼	`/columns`	가로 분할 레이아웃
탭	`/tabs`	탭으로 전환되는 영역
버튼	`/button`	워크플로우 실행 버튼
임베드	`/embed`	외부 콘텐츠 삽입
코드	`/code`	코드 블록 (구문 강조)

👉 임베드 블록 자세히 보기

단축키 모음

블록 생성

단축키	동작
`/`	블록 메뉴 열기
`Enter`	새 줄 (텍스트 블록)
`Shift + Enter`	블록 내 줄바꿈
`Tab`	들여쓰기
`Shift + Tab`	내어쓰기

블록 조작

단축키	동작
`Cmd/Ctrl + D`	블록 복제
`Cmd/Ctrl + Shift + ↑/↓`	블록 위/아래 이동
`Backspace` / `Delete`	블록 삭제
`Cmd/Ctrl + Z`	실행 취소
`Cmd/Ctrl + Shift + Z`	다시 실행