옵시디언 콜아웃은 긴 메모에서 주의사항과 보충 설명을 구분하는 상자예요. 기본 문법만으로 만들 수 있어 별도 플러그인을 먼저 설치할 필요가 없어요. 중요한 경고는 펼쳐 두고 긴 예시는 접어 두면 읽는 순서를 정리하기 좋아요.
1. 짧은 주의 상자부터 만들어요
첫 줄에 인용 기호와 유형을 적고, 다음 줄에도 인용 기호를 붙여 내용을 넣어요. 아래는 원본을 지키며 사진을 편집하는 메모 예시예요. 코드를 직접 복사할 때는 바깥의 코드 상자 표시가 아니라 안의 두 줄만 옮겨요.
> [!warning] 원본은 따로 보관해요> 연습은 사진 사본에서 시작하고 저장 이름을 확인해요.
유형 뒤의 문장은 상자 제목이에요. 제목은 읽는 사람이 해야 할 일을 알 수 있게 짧게 적어요. 중요한 내용이라는 말만 쓰는 것보다 원본은 따로 보관해요처럼 행동을 적는 편이 나중에 찾아보기 쉬워요. 본문에는 왜 필요한지나 어디에서 확인할지를 덧붙여요.
2. 긴 보충 설명은 접을 수 있게 해요
유형 표시 바로 뒤에 마이너스를 붙이면 처음에 접힌 상자, 플러스를 붙이면 처음에 펼쳐진 접기 가능한 상자가 돼요. 기호는 닫는 대괄호 바로 다음에 넣어요. 아래 예시의 추가 검수 항목은 필요할 때 펼쳐 읽는 보충 설명이에요.
> [!info]- 추가 검수 예시> 밝은 배경과 어두운 배경에서 가장자리를 각각 살펴봐요.> 전달용 파일도 따로 열어 결과를 확인해요.
다른 기호를 임의로 추가하지 말고 예시의 대괄호와 느낌표, 마이너스 위치를 그대로 확인하세요. 접었다고 내용이 지워지는 것은 아니에요. 다만 독자가 열어 보지 않을 수 있으니 작업 전에 꼭 알아야 할 위험이나 마감 조건은 접힌 상자 안에만 두지 않는 편이 좋아요.
3. 경고와 설명의 역할을 나눠요
예를 들어 집에서 프린터 사용 방법을 정리한다면 첫 부분에는 용지 방향처럼 바로 확인할 사항을 놓아요. 뒤에는 실패했을 때 비교할 출력 예시를 접힌 설명으로 둘 수 있어요. 모든 문장을 경고 상자로 만들면 무엇부터 읽어야 하는지 오히려 흐려져요. 한 화면에 강조하고 싶은 핵심을 먼저 정해요.
상자 제목만 읽어도 흐름이 이어지게 해요
제목을 주의, 참고, 기타로만 반복하지 말고 각각 확인할 일을 적어 보세요. 원본 파일 보관, 출력 전 용지 확인, 오류 화면 비교처럼 대상이 드러나면 좋아요. 같은 노트를 며칠 뒤 다시 볼 때 본문 전체를 읽지 않아도 필요한 상자를 찾을 수 있어요. 제목이 너무 길면 한 문장으로 줄이고 세부 조건은 본문으로 옮겨요.
4. 기존 문장은 명령으로 감쌀 수 있어요
명령 팔레트의 Insert callout은 기본 note 상자를 넣어요. 기존 텍스트를 선택한 뒤 이 명령을 실행하면 선택한 내용을 감쌀 수 있어요. 선택 범위가 맞는지 먼저 보고 짧은 문단으로 시험하세요. 유형과 사용자 지정 제목, 접기 기호는 Obsidian 공식 콜아웃 안내를 기준으로 확인했어요.
상자 밖에 남아야 할 다음 문단까지 선택했다면 먼저 실행 취소하고 범위를 다시 고르는 편이 좋아요. 선택을 잘못한 상태에서 기호를 여러 곳에 더하면 어느 줄이 상자 안인지 파악하기 어려워져요. 문서 전체를 한 번에 바꾸기보다 경고 하나와 설명 하나를 완성한 뒤 같은 원칙을 적용해요.
5. 모양이 안 나오면 문법과 표시 상태를 나눠 봐요
첫 줄의 느낌표와 대괄호가 빠지지 않았는지 확인하고, 둘째 줄이 같은 인용 블록에 들어갔는지 봐요. 예시를 코드 블록 안에 넣었다면 설명 상자 대신 문자 예시로 남는지 살펴요. 실제로 만들려는 것은 코드 예시인지 콜아웃인지 먼저 정하면 수정 방향이 명확해져요.
기본 유형의 모양은 테마나 사용자 설정에 따라 달라질 수 있어요. 색이 사진과 같지 않다고 문법 실패로 단정하지 마세요. 제목과 본문이 구분되는지, 접기 동작이 의도대로 되는지를 먼저 확인해요. 문제를 고치기 위해 처음부터 외부 플러그인을 더 설치하기보다 간단한 새 노트에 같은 두 줄을 넣어 비교하는 편이 안전해요.
예제 노트 하나로 읽는 순서를 검수해요
콜아웃을 처음 쓰는 노트라면 실제로 사용할 작업 하나를 정해요. 예를 들어 가족에게 프린터 사용 순서를 알려 주는 메모를 만든다고 해요. 상자 밖에는 전원 확인, 문서 열기, 미리보기라는 기본 흐름을 쓰고, 첫 출력 전에 꼭 봐야 할 용지 방향만 펼쳐진 경고로 넣어요. 과거 오류 화면이나 여러 용지 크기의 예시는 접힌 설명으로 분리해요. 이것은 모든 안내문에 적용할 정답이 아니라 중요도와 읽는 시점을 나누는 연습이에요.
먼저 상자를 전부 접은 상태에서 노트를 처음부터 읽어 보세요. 필수 단계가 빠졌거나 어디를 눌러야 할지 알 수 없다면 필요한 설명을 상자 밖으로 옮겨요. 접기 기능의 성공과 안내문의 성공은 달라요. 모든 버튼이 정상이어도 독자가 중요한 정보를 열어 보지 않으면 목적을 달성하지 못할 수 있어요. 상자 제목만 보고도 추가 설명을 열어야 하는 상황을 판단할 수 있게 적는 편이 좋아요.
그다음 보충 설명을 하나씩 펼쳐요. 제목에서 약속한 내용이 본문에 있는지 확인하고 관련 없는 메모는 다른 문단으로 옮겨요. 용지 걸림을 다룬 상자에 구매 후보와 잉크 가격까지 함께 넣으면 독자가 해결책을 찾기 어려워져요. 제목을 더 길게 만드는 대신 정보의 역할을 나누세요. 짧게 끝나는 설명이라면 꼭 접을 필요가 없다는 선택도 남겨 두면 돼요.
옮겨 적은 뒤 다른 사람의 읽기 순서로 봐요
본인은 내용을 알고 있어서 축약된 제목을 이해하기 쉬워요. 하지만 며칠 뒤 다시 읽거나 다른 사람이 읽을 때는 상황이 달라져요. 여기, 위 항목, 그 설정처럼 위치에 의존한 표현을 찾고 무엇을 말하는지 구체적으로 바꿔 보세요. 노트 앞부분을 고쳤을 때도 상자 안 문장이 그대로 이해되는지 보면 유지하기 쉬운 메모가 돼요.
작성 날짜나 작업 조건이 중요한 설명이라면 해당 내용 바로 옆에 적어요. 모든 주의 상자가 현재도 맞는지 한 번에 판단하기 어려울 수 있기 때문이에요. 예전 절차를 보관하려고 접었다면 제목에 과거 기록임을 드러내고 현재 절차와 나란히 읽히지 않도록 구분해요. 접혀 있다는 사실만으로 오래된 정보라는 의미가 전달되지는 않아요. 나중에 스스로 헷갈리지 않게 상태를 문장으로 남기는 것이 좋아요.
실패 양상을 나누면 불필요한 설정 변경을 줄여요
상자 자체가 생기지 않는 문제라면 가장 짧은 두 줄 예시에서 다시 시작해요. 상자는 생기는데 접히지 않는 문제라면 첫 줄 기호를 비교해요. 접히기는 하지만 읽기 어렵다면 내용 배치와 제목을 고쳐요. 이렇게 세 가지를 나누면 문장 정리로 해결할 문제 때문에 앱 설정을 초기화하거나 새 플러그인을 설치하는 일을 피할 수 있어요. 문제가 어디에 있는지 모를 때는 마지막으로 정상 작동했던 짧은 예시를 남겨 두세요.
다른 노트에서 가져온 문장을 감싼 뒤에는 원래 문단과 비교해 누락된 줄이 없는지 확인해요. 선택 범위가 짧아 마지막 문장만 상자 밖에 남거나, 반대로 다음 절 제목까지 안으로 들어간 경우를 찾는 거예요. 보기 좋은 색상보다 원래 의미가 그대로 남았는지가 먼저예요. 문서 전체를 고치기 전에 하나의 상자를 마치면 확인 범위가 작아져요.
콜아웃의 유형과 제목은 역할이 달라요. 유형은 상자의 종류를 정하고 제목은 그 안에서 무엇을 읽을지 알려 줘요. 예를 들어 warning이라는 문법을 유지한 채 제목만 한국어로 바꾸는 방식으로 시작하면 이해하기 쉬워요. 처음부터 여러 종류를 섞기보다 경고와 보충 설명 두 가지를 일관되게 쓰고, 필요가 분명해질 때 종류를 늘려 보세요.
검수를 마친 노트에서는 처음 읽는 사람이 다음 행동을 찾는 데 걸리는 과정을 생각해 봐요. 어느 상자를 펼쳐야 할지 제목만으로 알 수 없다면 제목부터 고치세요. 새 내용을 추가할 때도 같은 기준을 유지하면 오래된 경고와 최신 설명이 뒤섞이는 일을 줄일 수 있어요. 디자인이 예쁜 상태보다 필요한 정보를 빠짐없이 찾을 수 있는 상태를 완료 기준으로 삼으면 돼요.
옵시디언 콜아웃은 메모를 많이 꾸미기 위한 도구보다 읽는 순서를 정하는 도구로 쓰면 좋아요. 필수 주의사항을 보이게 두고 보충 예시를 필요한 순간에 펼치도록 정리하세요. 마지막에는 상자를 접은 상태에서도 중요한 행동과 조건이 빠지지 않는지 한 번 읽어 보면 돼요.