메신저·비주얼노블 뷰

대사로 쓴 원고, 그냥 읽지 말고 재생해 보세요! 프론트매터 한 줄이면 노트가 채팅이 실시간으로 오가는 메신저 화면이 되고, 배경·캐릭터·배경음이 살아 있는 비주얼노블 게임 화면이 됩니다. 🎮💬

← 홈으로: 옵시코 101 · 형제 글: 18-2 캐릭터 도감과 캐릭터 참조 · 18-1 이북·웹소설 뷰어

🎬 따라 해 보기: 노트가 단톡방이 됩니다 — 메신저 뷰 · 노트가 게임 화면이 됩니다 — 비주얼노블 뷰

---

1분 요약 ⏱️

• view: messenger → 폰 프레임 속 메신저 뷰 💬, view: visualnovel → 전체 화면 비주얼노블 뷰 🎮
• 대본은 18-2 캐릭터 도감과 캐릭터 참조의 <<이름:이미지>> 참조로 씁니다 — 정렬 접미사(|--/--|)가 말풍선 방향·서는 위치가 돼요.
• 클릭(Space/Enter) 한 번에 한 대사씩, ← 로 되감기, ▶ 자동 재생도 됩니다.
• 배경음·효과음·화면 연출·감정 모션·퇴장까지 — 연출 구문은 두 뷰가 똑같이 알아들어요.
• 문법을 외우기 어렵다면 에디터 왼쪽의 스토리 도구바 버튼으로 골라 넣으면 돼요(아래 4장).

1. 대본 쓰는 법 — 공통 문법 ✍️

프론트매터에 view: messenger 또는 view: visualnovel을 넣으면 상단 보기 메뉴(👁) 안에 해당 항목(‘메신저 뷰’·‘비주얼노블 뷰’)이 나타나요.

💡 두 가지만 지키면 돼요: ① view: 값은 영문이어야 해요 — messenger·visualnovel(웹소설·책은 webnovel·book). 대소문자는 가리지 않고 비주얼노블은 vn·visual-novel 로 줄여 써도 되지만, 메신저뷰처럼 한글로 쓰면 항목이 안 떠요. ② 대사 줄은 <<이름:이미지>> 토큰으로 시작해야 대사로 인식돼요(문장 중간에 있으면 그냥 서술로 나와요).

---
view: messenger
---
<<배경:골목길-밤.png>>
<<서연:서연-기본.png|-->> [10:23] 어디야? 다 왔어?
<<민준:민준-급함.png--|>> 미안 미안, 5분만!!
<<서연:서연-뾰로통.png!흔들|-->> 또 늦잠 잤지?
%%shake%%
민준은 전속력으로 달리기 시작했다.
<<민준:->>

정렬 접미사: 이미지명 뒤에 |--(왼쪽) 또는 --|(오른쪽)를 붙이고, 아무것도 안 붙이면 가운데예요. 메신저에선 말풍선 방향(오른쪽이 ‘나’), 비주얼노블에선 캐릭터가 서는 위치가 됩니다. << 자동완성의 3단계에서 골라도 돼요!

대사 자리에 파일을 넣으면 📎

<<서연:서연-기본.png>> ![[셀카.jpg]] 처럼 대사 자리에 첨부를 넣으면 —

• 이미지 → 메신저=사진 말풍선(클릭하면 크게), 비주얼노블=화면 가운데 CG
• 오디오([[음성.mp3]]) → 메신저=재생 버튼 있는 보이스 메시지
• 그 밖의 파일 → 메신저=파일 카드
• 텍스트 없이 토큰만 쓰면 메신저에선 그 캐릭터 이미지가 사진으로 전송돼요.
• 이모티콘(스티커) → ![[하트.png|스티커]]처럼 뒤에 |스티커를 붙이면 카톡 이모티콘처럼 틀 없는 큰 그림으로 보내요(메신저=말풍선 자리, 비주얼노블=말하는 캐릭터 옆에 팝업). 볼트에 「스티커」 폴더를 만들고 그림(png·gif·webp)을 넣으면 스토리 도구바의 이모티콘 버튼에 모아 보여 주고, 그 폴더 그림은 |스티커를 안 붙여도 이모티콘이 돼요. 움직이는 gif·webp도 그대로 움직여요.

연출 구문 🎇 — 두 뷰 공통!

2. 메신저 뷰 💬 — 채팅이 실시간으로

화면 가운데 폰 프레임이 뜨고, 클릭할 때마다 메시지가 하나씩 도착합니다.

• 연출이 진짜 같아요: 왼쪽 대사는 ••• 입력 중 말풍선이 먼저 뜨고, 오른쪽(나) 대사는 하단 입력창에 또각또각 타이핑된 뒤 전송돼요! 방금 보낸 메시지엔 읽음 ‘1’ 이 잠깐 붙었다 사라집니다.
• 시간 표시: [10:23]을 적으면 그 시각으로, 없으면 자연스러운 가짜 시간이 흘러가요. 같은 사람이 연달아 보내면 카카오처럼 마지막 말풍선에만 시간이 붙어요.
• 이모지만 1~3개인 메시지는 말풍선 없이 큼직하게 😆
• 단톡방 공지 📢: 대본에 > 인용문을 넣으면 채팅 위쪽에 고정 공지 바가 떠요(카카오 단톡방 공지처럼). 기본은 접혀 있고 탭하면 펼쳐집니다. 첫 대사 앞의 공지는 뷰를 켜자마자 상단에 보이고, 재생 도중 새 > 인용을 지날 때마다 그 순간 공지 내용이 교체돼요.
  • 대사(<<이름:이미지>>)가 하나도 없는 그냥 글을 메신저 뷰로 열면 > 인용·콜아웃은 공지로 빠지지 않고, 글 흐름 안에 인용 카드로 그대로 나와요(콜아웃은 [!info] 같은 표시만 떼고). 그래서 평범한 노트를 열어도 글이 사라지지 않아요.
• 링크가 진짜 메신저처럼 🔗: 대사·지문에 넣은 웹 주소는 클릭하면 열리고, 말풍선 아래에 미리보기 카드(제목·설명·썸네일)가 뜹니다. [[위키링크]]도 카드로 떠서 누르면 그 노트로 이동해요. 지문(내레이션)에 링크만 나열한 줄은 한 줄에 하나씩 예쁜 알약 버튼으로 정리되고, 문장 속 링크는 문장을 끊지 않고 그 자리에 작은 알약으로 들어가요. (웹 미리보기 이미지는 데스크탑 앱과 아이폰·아이패드·안드로이드 앱에서 채워져요. 브라우저에서 쓰는 웹판은 사이트에 따라 카드에 주소만 보일 수 있어요.)
• 테마 ◐: 기본 · 카카오 · 아이메시지 · 다크 — 입력창 색까지 같이 바뀝니다.
• 조작: ▶ 자동 재생(배속 ×1/×1.6/×2.4) · ⏭ 끝까지 펼치기 · ⏮ 처음부터 · ♪ 음소거 · ◐ 테마 · ← 한 칸 되감기(연출도 함께 되감겨요). 닫을 땐 폰 프레임 좌상단의 ‹(뒤로) 버튼이나 Esc를 누르세요. 읽던 위치는 문서별로 기억!

3. 비주얼노블 뷰 🎮 — 게임 화면처럼

전체 화면 무대 위에 배경이 깔리고, 캐릭터가 좌·중·우에 서서 대사를 말합니다.

• 무대: 배경 참조로 전환(부드러운 전환 + 은은한 Ken Burns 줌). 말하는 캐릭터는 또렷하게, 말이 없는 캐릭터는 살짝 물러나며 어두워져요. 같은 캐릭터의 표정(이미지) 교체도 크로스페이드로 슥 — 새 이미지를 미리 읽어 두었다가 겹치며 바뀝니다.
• 대사창: 프레임 없는 시네마틱 그라데이션 — 화자 이름은 color 색+외곽선으로 서는 위치 쪽에 뜨고, 대사는 타자기처럼 흘러나옵니다(마크다운 서식·강조색 지원).
• 선택지 분기: 내레이션 줄에 [[위키링크]]를 넣으면 선택지 버튼이 돼요! [[#소제목]]은 문서 안 점프, [[다른문서]]·[[다른문서#소제목]]은 다른 에피소드로 이어집니다. 인터랙티브 스토리 완성! 🌿
• 엔딩: 내용이 끝나면 화면이 어두워지며 ‘끝’ — 여운까지 챙겼습니다.
• 조작: 클릭/Space=다음, ←=되감기, ▶ 자동 재생(배속 ×1/×1.7/×2.6), 화면 꾹(또는 Ctrl 꾹)=스킵, 🔇 음소거, ⚙에서 글자 속도·크기 조절. 읽던 위치도 물론 기억해요.
• 📱 휴대폰·태블릿 앱에서는 무대가 열린 동안 시계·배터리를 숨기고 화면을 다 써요. 맨 위 메뉴(제목·돌아가기·제어 단추)는 화면 모서리에서 살짝 안쪽에 있어 잘 눌려요.

🎬 같은 원고, 세 가지 상영관: 하나의 대본을 웹소설 뷰로는 소설처럼, 메신저 뷰로는 채팅 드라마처럼, 비주얼노블 뷰로는 게임처럼 볼 수 있어요. view 값만 바꾸면 됩니다!

🤖 AI 에이전트가 이 문법을 전부 알아요(16 AI 에이전트): "이 소설을 메신저 뷰 대본으로 바꿔줘", "서연이랑 민준이 나오는 선택지 분기 비주얼노블 에피소드 써줘"라고 하면 등록된 캐릭터의 실제 이미지 파일명을 확인해서 문법에 맞는 대본을 만들어 줍니다. 필요한 캐릭터가 없으면 프론트매터 노트부터 만들어 줘요.

4. 스토리 도구바 🧰 — 버튼으로 대본 쓰기

프론트매터 view:가 스토리 뷰 네 가지(book·webnovel·messenger·visualnovel) 중 하나인 문서(웹소설은 type: 회차처럼 회차로 표시한 노트도)를 열면, 에디터 왼쪽 벽에 세로 도구바가 떠요. 문법을 외우지 않아도 버튼을 눌러 고르기만 하면 알맞은 마크다운을 대신 적어 줘요. 원고는 언제나 평범한 마크다운 그대로랍니다.

• 뷰마다 보이는 버튼이 달라요: 그 뷰에서 안 쓰는 버튼은 아예 숨겨요. 이북·웹소설은 캐릭터·장면 배경·배경음악·장면·미리보기에 원고용 네 버튼(이어 쓰기 준비·집필 기록·연재 전 점검·붙여넣기용 복사)이 나오고, 메신저는 원고용 네 버튼 없이 효과음·화면 효과·이모티콘·공지·시각이 더해지고, 비주얼노블은 공지·시각 대신 선택지가 들어가요.
• 폰·태블릿에서는: 도구바가 본문을 가리지 않게 처음엔 접혀 있어요. 맨 위 핸들(≡) 을 톡 누르면 펼쳐지고 접히고, 핸들을 끌면 도구바를 위아래로 옮길 수 있어요(옮긴 자리는 기억해요).

---

← 이전: 18-2 캐릭터 도감과 캐릭터 참조 · 처음으로 · 다음: 18-4 랜덤박스 →