Markdown으로 쓰기

Markdown은 연구 노트, 보고서, 초기 초안에 잘 맞습니다. Oleafly는 Markdown에 전용 서식 툴바와 Pandoc 빌드 경로를 제공하며, 소스 파일은 앱 밖에서도 그대로 쓸 수 있습니다.

보고서 만들기

1. 새 프로젝트 → 템플릿 사용 → Blank Markdown document를 선택하세요.
2. 프로젝트 이름을 현장 노트로 정하고 main.md 파일을 여세요.
3. 이 예제를 붙여 넣은 다음 다시 컴파일을 선택하거나 ⌘Enter / Ctrl+Enter 키를 누르세요.
4. Oleafly가 필요한 엔진을 설정하자고 제안하면 그 설정을 마치고 다시 컴파일하세요.

main.md

---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.

PDF에는 제목, 소제목, 번호 목록, 표가 있어야 합니다. 첫 번째 --- 줄 한 쌍 사이의 메타데이터가 문서 제목과 저자를 정합니다.

소스 편집과 비주얼 편집

툴바 맨 앞의 전환 스위치에는 모드가 세 가지 있습니다. 코드는 Markdown을 직접 편집합니다. 비주얼은 제목, 단락, 목록, 링크, 이미지, 표를 서식이 적용된 상태로 편집하게 해 줍니다. 둘 다는 소스와 서식이 적용된 텍스트를 함께 보여 줍니다. 메뉴를 열어 위아래나 분할을 고를 수 있습니다. 새 프로젝트는 코드로 열리며, 프로젝트마다 마지막에 쓰던 모드를 기억합니다.

밑줄, 형광펜, 위 첨자, 아래 첨자는 코드 모드의 Pandoc 서식 컨트롤입니다. 비주얼 모드에서는 이 버튼이 숨겨집니다. 메타데이터, 인용 구문, 그 밖의 소스 구성 요소를 다룰 때는 코드 모드를 쓰세요.

예제 소스 내려받기

모든 툴바 도구

서식 컨트롤을 클릭하기 전에 텍스트를 선택하세요. 코드 모드에서는 대부분의 도구가 선택 영역을 감싸거나 자리 표시자를 삽입합니다. 표시줄에 들어가지 않는 컨트롤은 추가 서식 옵션(…)에서 찾을 수 있습니다.

코드 / 비주얼

코드, 비주얼, 둘 다 사이를 전환합니다. 어느 모드에서든 문서는 Markdown 소스 그대로입니다.

실행 취소

마지막 편집을 되돌립니다. ⌘Z / Ctrl+Z.

다시 실행

실행 취소한 편집을 복원합니다. ⌘Shift+Z / Ctrl+Shift+Z.

제목 → 제목

제목 메뉴에서 제목을 선택하면 다음 코드가 삽입됩니다: # Title. 제목 텍스트를 직접 정한 제목으로 바꾸세요.

제목 → 절

제목 메뉴에서 절을 선택하면 다음 코드가 삽입됩니다: ## Section. 제목 텍스트를 직접 정한 제목으로 바꾸세요.

제목 → 소절

제목 메뉴에서 소절을 선택하면 다음 코드가 삽입됩니다: ### Subsection. 제목 텍스트를 직접 정한 제목으로 바꾸세요.

제목 → 소소절

제목 메뉴에서 소소절을 선택하면 다음 코드가 삽입됩니다: #### Subsubsection. 제목 텍스트를 직접 정한 제목으로 바꾸세요.

제목 → 작은 제목

제목 메뉴에서 작은 제목을 선택하면 다음 코드가 삽입됩니다: ##### Minor heading. 제목 텍스트를 직접 정한 제목으로 바꾸세요.

제목 → 단락 제목

제목 메뉴에서 단락 제목을 선택하면 다음 코드가 삽입됩니다: ###### Paragraph heading. 제목 텍스트를 직접 정한 제목으로 바꾸세요.

글머리 기호 목록

순서 없는 목록을 시작합니다. 결과는 - Item입니다.

번호 목록

순서 있는 목록을 시작합니다. 결과는 1. Item입니다.

할 일 목록

코드 모드에서 할 일을 추가하고, 끝나면 [ ] 대신 [x]를 쓰세요. 결과는 - [ ] Task입니다.

인용 블록

인용문을 별도의 줄에 놓으세요. 결과는 > quoted text입니다.

굵게

선택한 텍스트를 강조합니다. **text**, ⌘B / Ctrl+B.

기울임

용어를 강조합니다. *text*, ⌘I / Ctrl+I.

취소선

텍스트를 폐기된 것으로 표시합니다. ~~text~~.

인라인 코드

파일 이름, 명령, 식별자의 서식을 지정합니다. 백틱으로 감싼 텍스트가 됩니다.

밑줄

코드 모드에서 구절을 선택하세요. [text]{.underline}.

형광펜

코드 모드에서 구절을 선택하세요. [text]{.mark}.

위 첨자

코드 모드에서 지수를 선택하세요. ^text^.

아래 첨자

코드 모드에서 아래 첨자로 만들 부분을 선택하세요. ~text~.

밑줄과 형광펜은 Pandoc 속성을 쓰므로 서식이 PDF까지 이어집니다. 원고에 HTML 태그를 그대로 넣는 대신 이 컨트롤을 쓰세요.

링크 삽입

코드 모드: 삽입되는 코드는 [link text](url)입니다. 두 자리 표시자를 모두 바꾸세요.

비주얼 모드: 링크 URL이 열립니다. 주소를 입력해 선택 영역에 적용하세요. 링크는 없애고 텍스트만 남기려면 링크 제거를 쓰세요.

이미지 삽입

코드 모드: 삽입되는 코드는 ![caption](image-filename)입니다. 경로와 캡션을 바꾸세요.

비주얼 모드: 이미지 파일이 열립니다. figures/plot.png 같은 프로젝트 경로를 입력해 적용하세요.

표 삽입

코드 모드: 열 세 개, 머리글, 데이터 행 두 개가 삽입됩니다. 열 이름과 셀을 바꾸세요.

비주얼 모드: 같은 크기로 시작하는 편집 가능한 표가 삽입됩니다.

다이어그램 그리기

다이어그램 작성기를 Mermaid 모드로 엽니다. 캔버스에 순서도를 그리거나 Mermaid 코드를 편집한 다음 Mermaid로 삽입을 선택하면 펜스로 감싼 mermaid 코드 블록으로 커서 위치에 추가됩니다. Mermaid 다이어그램을 참고하세요.

문서 분석

문서의 제목, 그림, 표, 수식, 레이블, 인용, 할 일을 소스 순서대로 해당 줄로 연결된 목록으로 보여 줍니다. 또한 앞부분 메타데이터(front matter)에서 제목, 저자, 키워드, 날짜, 초록을 읽어 제출 양식에 쓸 수 있도록 복사할 수 있습니다. 문서 분석을 참고하세요.

문서 설정

문서 클래스, 용지 크기, 단, 여백, 본문 글꼴, 글꼴 크기, 언어, 줄 간격, 절 번호 매기기를 바꿉니다. Oleafly가 선택한 값을 Pandoc이 읽는 YAML front matter에 쓰며, 파일에 front matter 블록이 없으면 추가합니다. 문서 설정을 참고하세요.

프로젝트 정보

코드 모드: 프로젝트 통계와 선택 영역 정보를 보여 줍니다.

비주얼 모드: 비주얼 편집 화면의 통계를 보여 줍니다.

찾기

코드 모드: ⌘F / Ctrl+F로 활성 파일의 검색을 엽니다.

비주얼 모드: 소스 툴바의 찾기 버튼은 숨겨집니다.

이미지를 참조하기 전에 파일 트리로 가져오세요. 소스 압축 파일이 다른 컴퓨터에서도 동작하도록 이미지 경로는 원고 기준 상대 경로로 유지하세요.

수식과 코드 블록

인라인 수식은 $x^2$처럼 쓰세요. 별행 수식은 달러 기호 두 쌍 사이에 넣으세요.

$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$

코드 예시는 코드를 백틱 세 개로 감싸고 여는 펜스 뒤에 언어를 적으세요. 이것들은 소스 구문이며, Markdown 툴바에는 수식이나 펜스 코드 블록 전용 버튼이 따로 없습니다.

Mermaid 다이어그램

툴바에서 다이어그램 그리기를 선택하면 다이어그램 작성기에서 Mermaid 순서도를 만들 수 있습니다. Mermaid로 삽입은 이를 펜스 코드 블록으로 추가합니다.

```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```

둘 다 모드에서는 서식이 적용된 쪽이 블록을 다이어그램으로 그려 줍니다. PDF에는 이미지가 필요하므로 작성기는 렌더링된 PNG를 figures/mermaid-<hash>.png에 함께 저장하고, 컴파일할 때 블록 대신 그 이미지를 넣습니다. 그래서 다이어그램이 컴파일된 PDF에도 나타납니다. 나중에 블록을 직접 편집하면, 작성기에서 다이어그램을 다시 삽입하거나 저장하기 전까지 PDF에는 코드가 표시됩니다. Markdown 문서의 Mermaid를 참고하세요.

인용과 참고문헌

references.bib 파일을 가져오거나 만들고, YAML 메타데이터에 bibliography: references.bib 줄을 추가한 다음, [@citation-key]로 기존 키를 인용하세요. Pandoc이 참고문헌을 사용해 서식이 갖춰진 인용과 참고문헌 목록을 만듭니다.

참고문헌 찾기 및 관리 →

가져오기와 내보내기

기존 초안을 Markdown으로 유지하려면 Blank Markdown document를 만들고, 초안을 main.md에 붙여 넣고, 이미지와 참고문헌을 가져오세요. 라이브러리의 별도 Markdown 문서 가져오기는 현재 초안을 LaTeX로 변환합니다. 가져오기 경로에서 두 방법을 설명합니다.

PDF는 컴파일해서 만들고, Word, HTML, Typst, LaTeX, 일반 텍스트는 내보내기로 만드세요. 원본 Markdown과 그 자산을 공유하려면 소스 ZIP을 쓰세요. 작업 내보내기에서 순서와 변환된 파일에서 확인할 사항을 다룹니다.