편집

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

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

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

네. Baram의 핵심 원칙은 무손실 왕복 충실성입니다 — 마크다운 파일을 열고 편집하고 저장하면 내용이 정확히 보존되며, Baram이 스스로 렌더하지 않는 문법도 그렇습니다. 독자 형식도, 숨은 데이터베이스도 없습니다. 표 열 폭이나 다이어그램 크기처럼 배치와 관련된 기능을 쓰면, Baram은 그 메타데이터를 파일 안의 평범하고 눈에 보이는 마크다운 주석으로 저장합니다 — 다른 에디터는 그냥 무시하는 주석입니다.

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

파일은 언제나 평범한 텍스트이고, 떠나기 위해 내보내거나 변환할 것이 아무것도 없습니다 — 종속(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)을 누르거나, 우클릭해 Merge Cells를 고릅니다
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)로 전체 검색을 엽니다. 워크스페이스의 모든 파일을 전문 검색합니다. 정규식, 파일·폴더 필터, 파일 전체 바꾸기를 지원합니다.

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

제목(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 에디터에서 원본 마크다운을 보여 주므로, 정확한 편집이나 서식 문제를 살필 때 좋습니다.

---