인용과 주석
인용과 주석은 Markdown 본문에 쓰는 표식입니다. 이 페이지는 전체 문법을 설명합니다. 보통은 삽입 > 인용 대화상자가 표식을 대신 써 주므로 직접 입력할 필요가 거의 없습니다.
기본 문법
인용의 전체 형태는 다음과 같습니다.
[@<플래그><형태 기호><항목 ID>::접두어;;접미어##위치 유형&&위치@]가장 간단한 인용은 항목 ID만 있는 [@smith2020@]입니다. 항목 ID는 라이브러리에서 각 항목을 구분하는 고유 식별자이며, 글자나 숫자로 시작하고 글자, 숫자, 마침표, 밑줄, 하이픈을 쓸 수 있습니다.
붙어 있는 여러 인용은 하나의 인용 묶음이 되어 한 덩어리로 조판됩니다. [@smith2020@][@lee2019@]처럼 쓰고, 묶음 안의 표식 사이에는 공백을 두지 마세요.
[[@…]]는 Obsidian의 위키 링크이고 ![[@…]]는 임베드입니다. 이들은 인용이 아니며 CiteDesk은 건드리지 않습니다.
세 가지 형태
| 문법 | 형태 | 의미 |
|---|---|---|
[@smith2020@] | 괄호형 | 기본 형태이며 인용 전체가 괄호나 각주 안에 들어갑니다 |
[@!smith2020@] | 서술형 | 저자가 문장 안에 나오고 괄호에는 연도 등만 남습니다. 본문 인용 스타일에서만 효과가 있습니다 |
[@-smith2020@] | 저자 생략 | 저자 없이 연도 등만 나옵니다 |
!와 -는 함께 쓸 수 없으며 하나만 쓸 수 있습니다. 선택한 스타일에 서술형이 없으면 인용 문구 대신 짧은 설명이 표시됩니다.
위치 정보
위치 정보는 저작의 어느 부분을 인용했는지, 예를 들어 쪽, 장, 절을 나타냅니다. 두 부분으로 이루어지며 반드시 짝으로 써야 합니다.
##뒤에는 위치 유형을 씁니다.page(쪽),chapter(장),section(절),paragraph(단락) 같은 CSL 유형 이름입니다.&&뒤에는 위치 자체를 씁니다. 예:12-15.
예를 들어 [@smith2020##page&&12-15@]처럼 씁니다. 유형을 위치 안에 넣을 수 없고, 둘 중 하나만 쓸 수도 없습니다.
인용 대화상자에서는 쪽수 등을 주 입력란에 바로 입력할 수 있고, 대화상자가 이 형태로 바꿔 씁니다.
접두어와 접미어
::뒤는 접두어,;;뒤는 접미어이며, 둘 다 쓴 그대로의 문자열로 인용에 들어갑니다.- 접미어에 쪽수를 써도 위치 정보로 해석되지 않습니다. 위치 정보는
##와&&로 쓰세요.
표준 순서는 접두어, 접미어, 위치 유형, 위치입니다. 해석할 때는 각 부분의 순서가 바뀌어도 되지만 각 부분은 한 번만 쓸 수 있습니다. 예:
[@smith2020::참조;;3장도 보라##page&&12@]접두어, 접미어, 위치에는 구분자(::, ;;, ##, &&)나 표식의 시작과 끝을 쓸 수 없습니다. 쓰면 표식을 잘못 읽게 되므로 편집 대화상자가 입력란 아래에 알려 줍니다.
입력한 순서 유지
인용 묶음 안의 항목 순서는 기본적으로 스타일이 정합니다. 쓴 순서대로 두려면 묶음의 아무 표식 맨 앞에 =를 붙입니다. 예: [@=smith2020@][@lee2019@]. =는 !나 -와 순서에 상관없이 함께 쓸 수 있습니다. [@=-smith2020@]. 인용 대화상자에서 항목이 둘 이상인 묶음에는 "입력한 순서 유지" 옵션이 있고, 이 옵션이 묶음의 모든 표식에 =를 붙이거나 뗍니다.
라이브러리에서 끌어다 놓기
라이브러리의 항목 목록에서 항목 행을, 또는 작성 사이드바에서 항목 카드를 본문으로 끌어다 놓으면, 놓은 위치에 그 항목들의 인용 표식이 쓰입니다. 여러 항목을 한 번에 끌면 하나의 인용 묶음으로 이어집니다. 예: [@smith2020@][@lee2019@]. 삽입은 삽입 > 인용과 같은 한 번의 편집이며 한 번에 실행 취소할 수 있습니다. 코드 블록 안이나 다른 인용·주석 표식 안에 놓으면 안내와 함께 거부됩니다.
항목 목록의 노트 행을 본문으로 끌어다 놓으면 노트 전체가 Markdown으로 변환됩니다. 노트 안의 인용은 인용 표식이 되고, 삽입된 이미지는 작업 공간에 저장됩니다(위치는 설정의 새 첨부 파일을 생성할 위치). 항목과 노트를 함께 끌면 인용 표식을 먼저 쓰고 노트가 뒤따르며, 각각 한 번의 편집입니다. 첨부 파일 행은 이미지와 파일 붙여넣기·끌어다 놓기를 보세요.
Zotero는 텍스트 편집기로 끌어다 놓은 항목을 서식이 적용된 인용 문구로 씁니다. CiteDesk의 Markdown 문서는 표식만 저장하고 서식이 적용된 결과는 저장하지 않으므로, 본문에는 표식이 쓰이고 서식은 스타일이 정합니다.
주석
주석은 본문 속의 곁글입니다.
[@?@]주석의 내용입니다. 안에 인용 [@smith2020@]을 넣을 수도 있습니다.[@/?@]각주 스타일에서는 주석 하나와 최상위 인용 묶음 하나가 각각 각주 하나를 차지하며, 본문에 나오는 순서대로 번호가 붙습니다. 주석 안에 들어 있는 인용은 그 주석의 각주 안에 놓이고 번호를 따로 차지하지 않습니다. 본문 인용 스타일에서도 주석은 각주로 조판됩니다. 주석을 쓰려면 오른쪽 창의 인용 페이지에서 주석 삽입 버튼을 누르세요.
CiteDesk의 각주는 인용과 주석에서만 만들어집니다. CiteDesk은 Markdown 고유 각주([^…], ^[…], 각주 정의)를 처리하지 않습니다. 그런 각주는 번호를 차지하지 않으며 조판되지도 않습니다. 내보낸 원고에 CiteDesk이 쓰는 각주는 [^citedesk-1] 같은 식별자를 씁니다.
표식을 직접 입력할 때
표식을 손으로 입력하면 문서가 망가질 수 있어서 Markdown 편집기가 일부 입력을 막습니다. 입력한 글자가 이웃 글자와 이어져 [^, ^[, [@가 되면, 그 글자는 문서에 들어가지 않고 안내가 나오며 "인용 추가/편집" 대화상자가 열립니다. 확인하면 대화상자가 관련된 글자를 올바른 표식으로 바꿔 줍니다.
막지 않는 경우: 코드 블록 같은 원문 그대로 영역의 글자, 백슬래시로 이스케이프한 글자, [[@ 같은 위키 링크와 임베드. 붙여넣거나 끌어다 놓은 [^, ^[는 막을 수 없어서 경고만 합니다. 붙여넣은 [@…@]는 다른 곳에서 복사한 인용으로 보고 그대로 받아들입니다.
인식하지 않는 영역
다음 위치의 [@…@]는 인용이 아니며 참고 문헌 목록에 들어가지 않습니다. 펜스 코드와 들여쓰기 코드, 인라인 코드, 수식, HTML 블록과 인라인 HTML 태그, <…> 자동 링크, %%…%%와 <!--…--> 주석, 그 밖에 Obsidian의 구문 분석이 원문 그대로 출력하는 구조. 실시간 미리보기도 같은 판단을 하므로 코드처럼 보이는 곳에서는 효과가 없습니다.