편집

WYSIWYG 모드는 어떻게 동작하나요?

커서가 서식이 걸린 텍스트 밖에 있으면 Baram이 마크다운 구분자(**, *, ` 같은 것)를 숨깁니다. 굵은 단어 안으로 커서를 옮기면 편집을 위해 ** 표시가 다시 나타납니다. 벗어나면 서식이 적용된 텍스트만 남습니다. 마크다운에 온전히 닿으면서도 깔끔하게 쓸 수 있습니다.

마크다운이 정확히 보존되나요?

모든 경우에 byte 단위로 같지는 않지만, 쓴 내용은 그대로 돌아옵니다. Baram은 무손실 왕복 충실성을 목표로 만들어졌습니다 — 마크다운 파일을 열고 편집하고 저장하면 쓴 것이 모두 남아 있고, Baram이 스스로 렌더하지 않는 문법도 그렇습니다. 바뀔 수 있는 것은 내용이 아니라 표기입니다. 저장할 때 몇 가지 마크다운 표기를 표준형으로 맞추므로(목록 글머리는 -, 굵게는 **, 기울임은 *, 가로줄은 ---, 코드 블록은 펜스), + 글머리나 __굵게__로 쓴 파일은 표준 표기로 돌아옵니다. 독자 형식도, 숨은 데이터베이스도 없습니다. 표 열 폭이나 다이어그램 크기처럼 배치와 관련된 기능을 쓰면, Baram은 그 메타데이터를 파일 안의 평범하고 눈에 보이는 마크다운 주석으로 저장합니다 — 다른 에디터는 그냥 무시하는 주석입니다.

지금 내용에 영향을 주는 예외가 하나 있습니다. 참조 스타일(reference-style) 링크와 이미지입니다. 마크다운에서는 본문에 [텍스트][이름](또는 [이름][], [이름], ![대체 텍스트][이름])만 쓰고 주소는 [이름]: https://… 같은 별도의 정의 줄에 둘 수 있습니다. Baram은 파일을 열 때 이 참조를 해석하므로, 저장하면 링크는 인라인 형태 [텍스트](https://…)로 쓰이고 정의 줄은 모두 사라집니다. 아무도 참조하지 않는 정의, 코드 펜스 안에서만 참조되는 정의(펜스 안의 글은 참조가 아닙니다), 같은 이름의 두 번째 정의(CommonMark처럼 첫 번째가 이깁니다)도 함께 사라집니다. 맞는 정의가 없는 참조는 애초에 링크가 아니라서 대괄호가 있는 글자 그대로 남습니다(저장 시 대괄호 앞에 백슬래시가 붙을 수 있습니다). 참조 형태를 byte 단위로 보존하는 일은 이슈 #600에서 다룹니다.

편집한 HTML 블록은 파일이 읽을 블록으로 바뀔 수 있습니다. 마크다운은 <div> 같은 HTML 블록을 빈 줄(공백만 있는 줄도 빈 줄입니다)에서 끝내고, HTML 블록처럼 시작하지 않는 글은 HTML 블록이 아닙니다. 블록 편집을 마치면 Baram은 그 글을 파일을 열 때처럼 읽습니다. 앞뒤에 문단이 하나씩 있다고 보고(문서의 첫 블록이면 파일 맨 앞에 놓고), 문서의 각주 정의와 함께 읽습니다. 읽힌 블록이 올바르고 다시 저장해도 같게 읽히는 마크다운이 되면, 그 블록들이 HTML 블록 자리에 들어갑니다. <div> 줄, 빈 줄, 글, </div> 줄은 HTML 블록 · 문단 · HTML 블록이 되고, 그냥 글은 문단이 됩니다. 실행 취소(Cmd+Z / Ctrl+Z)를 하면 편집하기 전의 블록으로 돌아옵니다. 그렇지 않으면 블록은 친 그대로 남고, 파일이 다르게 읽는다는 알림(<img src="photo.png">는 이미지로, 글 줄 안의 <span>은 그 안의 글로만 읽힙니다)이나 옆 블록과 합쳐질 수 있다는 알림(닫히지 않은 <!--나 <pre>는 뒤의 블록까지 담습니다)이 뜹니다.

제 파일이 여전히 “표준” 마크다운인가요?

파일은 언제나 평범한 텍스트이고, 떠나기 위해 내보내거나 변환할 것이 아무것도 없습니다 — 종속(lock-in) 관점에서 중요한 것은 그 점입니다. 그 안의 모든 구성물이 표준인지는 어떤 기능을 쓰는지에 달려 있습니다.

• 순수 CommonMark / GFM — 제목, 목록, 표, 할 일 목록, 링크, 이미지, 코드 블록, 강조, 취소선, 각주.
• 다른 도구도 읽는 널리 쓰이는 관례 — YAML 전문, $math$와 $$math$$, > [!NOTE] 콜아웃, ==highlight==, ~sub~ / ^sup^, 정의 목록, [TOC], 그리고 📅/⏫/🔁 태스크 필드(Obsidian Tasks 플러그인과 같은 어휘).
• 위키 스타일 확장 — [[위키링크]], #태그, @[[언급]], 블록 참조 ((file#^id)), 블록 임베드 {{embed ((file#^id))}}, 그리고 ```query 블록. 평범한 마크다운 리더는 이것들을 버리지 않고 글자 그대로(쿼리 블록은 코드 블록으로) 보여 줍니다.

어느 것도 바이너리이거나 암호화되거나 파일 밖에 저장되지 않으므로, 어떤 에디터로든 노트를 열고 읽고 고칠 수 있습니다.

어떤 파일 형식을 지원하나요?

Baram이 편집하는 것은 표준 마크다운 파일(.md, .markdown)입니다. CommonMark, GitHub Flavored Markdown(GFM) 확장(표, 할 일 목록, 취소선), 그리고 수식($, $$)·YAML 전문·콜아웃(> [!type])·위키링크([[page]])를 위한 추가 문법을 지원합니다.

몇 가지 다른 종류도 앱 안에서 엽니다. 보려고 앱을 떠날 필요가 없습니다.

• PDF(.pdf) — 찾기, 확대·축소, 페이지·하이라이트 패널, 그리고 노트에서 인용할 수 있는 텍스트·영역 하이라이트가 있는 리더. PDF 파일 자체는 절대 수정하지 않습니다.
• HTML(.html, .htm) — 미리보기 / 소스 전환이 있는 렌더된 실시간 미리보기. 소스는 편집할 수 있고 평범하게 저장됩니다.
• 이미지(.png, .jpg, .jpeg, .gif, .bmp, .ico, .webp, .avif) 와 SVG(.svg) — 확대·축소가 되는 읽기 전용 뷰어.

사용 설명서의 다른 종류의 파일 보기를 보십시오. 플러그인이 더 많은 파일 종류의 뷰어를 더할 수 있습니다.

표를 어떻게 넣나요?

네 가지 방법이 있습니다.

1. 파이프 입력 — | 헤더 1 | 헤더 2 |를 입력하고 Enter를 누르면 헤더가 채워진 표가 만들어집니다
2. 격자 선택 — /table을 입력하거나 Cmd+T를 눌러 10×10 격자에서 크기를 고릅니다
3. TSV 붙여넣기 — 스프레드시트에서 셀을 복사해 붙여넣으면 표가 자동으로 만들어집니다
4. GFM 파이프 표 문법을 직접 씁니다

만든 뒤에는 Tab과 Shift+Tab으로 셀을 오갑니다. 열 경계를 끌어 폭을 조정합니다(세션에만 남습니다). 표에 마우스를 올리면 행·열을 추가하는 ⊕ 버튼이 보입니다. 우클릭하면 정렬, 헤더 전환, 복사 항목이 나옵니다.

표 셀을 어떻게 병합하나요?

1. 병합할 셀들을 클릭한 채 끌어 선택합니다
2. Cmd+M(macOS) / Ctrl+M(Windows/Linux)을 누르거나, 우클릭해 표 셀 병합을 고릅니다
3. 병합된 셀을 다시 나누려면 그 안에 커서를 두고 Cmd+M을 다시 누릅니다

유지: 셀 병합은 파이프 표 안의 <(colspan)와 ^(rowspan) 표시로 마크다운 파일에 저장됩니다. 그래서 소스 모드 전환(Cmd+/), 파일 닫고 다시 열기를 견디고 Obsidian Sheets Extended와 호환됩니다. 지원하지 않는 마크다운 뷰어에서는 그 표시가 그냥 셀 텍스트로 보입니다.

수식을 어떻게 넣나요?

• 블록 수식: $$를 입력하고 Enter를 누르거나 Cmd+Shift+M을 씁니다
• 인라인 수식: $수식$을 입력합니다

수식은 KaTeX로 렌더됩니다. 입력하는 동안 실시간 미리보기가 보입니다.

코드 블록은 어떻게 쓰나요?

``` 뒤에 언어 이름(예: python, javascript)을 적고 Enter를 누릅니다. Baram이 그 언어의 구문 강조가 되는 CodeMirror 6 에디터를 만듭니다. 14개 언어를 지원합니다.

콜아웃 블록은 어떻게 만드나요?

줄 맨 앞에 > [!info]를 입력하거나 슬래시 명령 /callout을 씁니다. 콜아웃 종류 12개를 지원합니다 — info, tip, warning, danger, note, abstract, todo, success, question, failure, example, quote. 종류 뒤에 -를 붙이면 접을 수 있게 됩니다.

토글(접히는) 블록은 어떻게 만드나요?

슬래시 명령 /toggle을 쓰거나, 제목을 요약으로 쓰려면 /toggle heading 1을 씁니다. 화살표 표시를 클릭하거나 Cmd+Enter로 열고 닫습니다. 마크다운에서는 토글이 HTML <details> / <summary> 문법을 씁니다.

Mermaid 다이어그램은 어떻게 넣나요?

슬래시 명령 /mermaid를 쓰거나 Cmd+Shift+D를 누릅니다. Mermaid 문법을 쓰면 아래에 실시간 미리보기가 렌더됩니다. 플로차트, 시퀀스 다이어그램, 클래스 다이어그램 등을 지원합니다.

각주는 어떻게 쓰나요?

본문 어디에든 [^id](예: [^1] 또는 [^note])를 입력하면 각주 참조가 들어갑니다. 문서 끝에 각주 정의 블록이 자동으로 만들어지고, 그 안을 클릭해 각주 내용을 씁니다. 참조는 문서 순서에 따라 차례 번호(1, 2, 3…)로 표시됩니다. 참조에 마우스를 올리면 툴팁 미리보기가 나오고, 클릭하면 참조와 정의 사이를 오갑니다.

모든 파일을 검색하려면?

Cmd+Shift+F(macOS) 또는 Ctrl+Shift+F(Windows/Linux)로 전체 검색을 엽니다. 워크스페이스의 모든 파일을 전문 검색합니다. 정규식, 파일·폴더 필터, 파일 전체 바꾸기를 지원합니다.

바꾸기와 모두 바꾸기는 검색과 같은 규칙으로, 한 줄씩 찾습니다. 정규식을 켜면 바꿀 내용에서 일치 전체를 $0으로, 그룹을 $1이나 ${name}으로 가리킵니다. 뒤에 영문자·숫자·밑줄이 이어지면 ${1}처럼 쓰고, 달러 기호 자체는 $$로 씁니다. 정규식을 끄면 바꿀 내용을 친 그대로 넣습니다. 편집기의 찾기 및 바꾸기(Cmd+H / Ctrl+H)는 정규식을 켜든 끄든 늘 친 그대로 넣습니다.

제목 구역을 어떻게 접나요?

제목(H1–H6)에 마우스를 올리면 왼쪽 여백에 접기 화살표가 나옵니다. 화살표를 클릭하면 같은 수준 이상의 다음 제목이 나올 때까지 그 아래 내용이 접힙니다. 다시 클릭하거나 ... 표시를 클릭하면 펼쳐집니다. 커서 위치에서 Cmd+Shift+[(macOS) / Ctrl+Shift+[(Windows/Linux)로 접고 펼칠 수도 있습니다.

중첩 목록은 어떻게 접나요?

하위 목록(글머리 기호·번호 매기기·할 일)을 가진 항목에 마우스를 올리면 접기 화살표가 나옵니다. 화살표를 클릭하면 하위 항목이 접힙니다. 중첩 깊이와 무관하게 동작합니다.

한 번에 전부 접고 펼치려면?

Cmd+Shift+Alt+[(macOS) / Ctrl+Shift+Alt+[(Windows/Linux)로 모든 제목과 중첩 목록 항목을 접습니다. Cmd+Shift+Alt+] / Ctrl+Shift+Alt+]로 전부 펼칩니다.

접기가 마크다운 파일을 바꾸나요?

아니요. 접기는 순전히 보기 수준의 기능입니다 — 문서를 바꾸지 않고, 실행 취소 기록에도 영향을 주지 않으며, 저장되는 파일도 그대로입니다. 접기 상태는 탭을 옮겨 다녀도 파일마다 유지됩니다.

소스 모드가 무엇인가요?

Cmd+/(macOS) 또는 Ctrl+/(Windows/Linux)로 소스 모드를 전환합니다. 실행 취소·복귀가 온전히 되는 CodeMirror 에디터에서 원본 마크다운을 보여 주므로, 정확한 편집이나 서식 문제를 살필 때 좋습니다.

---