이미지와 동영상

이미지

이미지를 넣는 방법은 여럿입니다.

1. 이미지 파일을 에디터로 끌어다 놓기
2. 클립보드에서 이미지 붙여넣기(Cmd+V)
3. 마크다운 문법 입력: ![대체 텍스트](image-url)
4. 슬래시 명령 /image

이미지에 마우스를 올리면 크기 조정(25% / 50% / 75% / 100%)과 대체 텍스트 편집 툴바가 나옵니다.

미리보기와 원본. 문서 안의 이미지는 파일 자체가 아니라 캐시된 미리보기(긴 변 최대 2048px)로 그려집니다. 그래서 카메라 원본 크기의 사진이 가득한 페이지도 멈추지 않고 열립니다. 호버 툴바의 원본 보기 버튼(⤢)을 누르면 원해상도 파일을 볼 수 있고, Esc로 빠져나옵니다. 어느 쪽이든 마크다운은 그대로입니다 — 적어 둔 경로가 파일에 남고 내보낼 때도 그것이 쓰입니다.

동영상

동영상은 이미지와 같은 문법으로 넣습니다.

1. 로컬 파일 — ![설명](assets/clip.mp4). 동영상 파일을 끌어다 놓으면 문서 옆 assets/ 폴더로 복사됩니다.
2. 직접 링크 — ![](https://example.com/clip.mp4)
3. YouTube / Vimeo — ![](https://youtu.be/VIDEO_ID)

로컬·원격 동영상 파일은 렌더되는 순간부터 네이티브 재생 컨트롤을 갖습니다 — 먼저 눌러야 하는 별도의 포스터 프레임이나 재생 버튼이 없습니다. YouTube·Vimeo 임베드도 같은 방식으로, 문서가 열리는 즉시 플레이어를 불러옵니다. 즉 그 시점에 제공자에게 연결됩니다. 설정 → 에디터 → 동영상 임베드 자동 로드를 끄면 임베드가 호스트 이름을 적은 카드로 나타나고, 클릭해 플레이어를 불러올 때까지 YouTube·Vimeo에서 아무것도 내려받지 않습니다. 직접 넣은 원격 동영상 URL도 재생을 누를 때까지 호스트에서 아무것도 가져오지 않습니다 — 문서를 여는 것만으로는 연결하지 않습니다. 로컬·원격 동영상 파일은 가장자리를 끌어 크기를 조정할 수 있고, 그 값은 <video src="…" width="60%"></video>로 저장됩니다. 제공자 임베드는 항상 16:9 비율의 전체 폭입니다.

.mp4(H.264)는 모든 플랫폼에서 재생됩니다. .webm·.mov·.ogv는 플랫폼의 미디어 지원에 달려 있습니다 — 재생할 수 없으면 에디터가 빈 화면을 보이는 대신 그렇다고 알려 줍니다. .mkv는 어느 플랫폼에서도 인식되는 동영상 컨테이너가 아니라서 Baram이 동영상으로 아예 취급하지 않습니다 — 표시되지 않는 이미지 참조로 떨어집니다. .mp4로 변환하십시오.

HTML로 내보내면 로컬 동영상은 문서에서 갖고 있던 상대 경로를 그대로 유지합니다 — assets/clip.mp4는 assets/clip.mp4로 남고 파일에 박아 넣지 않습니다. 따라서 assets 폴더(중첩 경로라면 동영상이 있는 그 위치)가 내보낸 HTML 파일 옆의 같은 상대 위치에 있어야 재생됩니다. 문서 디렉터리 밖을 절대 경로로 가리킨 동영상은 그 절대 경로를 그대로 유지하므로, 내보낸 그 기기에서만 재생됩니다.