> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ko/in-depth-articles/32-markdown-into-latex-with-style.md).

# 스타일이 적용된 Markdown을 LaTeX로

**출판 후 업데이트** (2017년 5월 13일): 우리는 Vít Novotný, markdown 패키지의 저자/관리자인 `마크다운` 원문 기사와 관련해 도움이 되는 피드백을 보내주신 것에 대해 감사드립니다. 우리는 그의 조언과 제안을 반영해 포함한 이 업데이트된 버전을 기쁘게 공개합니다.

### 소개

얼마 전 우리는 [`markdown 패키지`](http://www.ctan.org/pkg/markdown) 의 출시를 기뻐했는데, 이는 LaTeX 문서에 마크다운 문법을 작성할 수 있게 해 주었고, 이를 [Overleaf에서 Markdown으로 작성하는 방법](/latex/ko/in-depth-articles/30-how-to-write-in-markdown-on-overleaf.md) 의 목적은 지원되는 몇 가지 문법을 보여 주는 것이었습니다.

**기억하세요**: 컴파일해야 할 `.tex` 파일들을 `--shell-escape` 옵션과 함께 컴파일해야 로컬 LaTeX 설치에서 작동합니다. Overleaf는 이를 자동으로 대신해 줍니다. 대부분의 저널 제출 포털은 `--shell-escape`를 활성화하지 않으므로 염두에 두세요. 원고의 출력 PDF만 업로드할 수 있도록 허용된 경우가 아니라면, markdown이 포함된 LaTeX 파일은 출판사의 제출 시스템에서 처리될 때 성공적으로 컴파일되지 않을 수 있습니다.

에서 암시된 아이디어 중 하나는 [이전 기사](/latex/ko/in-depth-articles/30-how-to-write-in-markdown-on-overleaf.md) 마크다운과 LaTeX의 조합이 내용과 스타일을 훌륭하게 분리할 수 있게 해 준다는 것입니다. 작성자들(특히 이미 마크다운에 익숙한 사람들)은 훨씬 더 간결한 문법을 사용할 수 있게 되면서도(몇 가지 주의점은 있지만) 스타일과 서식을 처리해 주는 LaTeX 패키지와 템플릿의 모든 장점을 그대로 활용할 수 있습니다. 그 [이전 기사](/latex/ko/in-depth-articles/30-how-to-write-in-markdown-on-overleaf.md) 는 마크다운을 [Beamer 발표자료](https://www.overleaf.com/read/dnrwnjrpjjhw) 및 [포스터에서](https://www.overleaf.com/read/jtbgmmgqrqmh): 오늘은 훨씬 더 재미있고 흥미로운 스타일링 가능성을 살펴보겠습니다!

### 스타일이 적용된 LaTeX 템플릿에서 마크다운 사용하기

위의 예시 외에도, 거의 모든 템플릿에서 마크다운을 사용할 수 있습니다. 몇 가지 간단한 예시를 소개합니다:

* 다음 [Legrange 오렌지 북](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) 템플릿
* 다음 [Tufte에서 영감을 받은 유인물](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) 템플릿
* 이 [아주 멋진 기사 템플릿](https://www.overleaf.com/read/xfsrpsmdtqvt) Thiago가 만든

이 중 두 개는 기사 템플릿이고 하나는 책 템플릿이라는 점을 알 수 있을 것입니다. 그 [`markdown 패키지`](http://www.ctan.org/pkg/markdown) 감지하며 `\chapter` 명령이 특정 LaTeX 문서에서 사용 가능한지 감지하고 첫 번째 수준 제목을 `마크다운` 줄로 렌더링하며 `\chapter` 또는 `\\section` 적절하게.

### 정말 빠른 유인물: 마크다운 + 포켓모드

제가 처음 마크다운에 대해 알게 되었을 때, 그것은 메모를 빠르고 편리하게 남기는 방법으로 느껴졌습니다. 마치 종이 조각이나 포스트잇에 메모를 휘갈겨 적는 방식과 비슷했기 때문입니다—특히 글머리표와 번호 목록 문법이 그렇습니다. 제가 처음 [PocketMod 템플릿](https://www.overleaf.com/read/nqbhpnrkskrx) 을 2015년에 만들었을 때, PocketMod를 만들 수 있도록 LaTeX에서 마크다운을 작성할 방법을 간절히 바랐습니다. *다음으로 바꾸면* 마크다운은… 적절하다고 느껴졌기 때문입니다. 작은 접이식 책자에 단순한 문법으로 메모를 적되, 멋진 타이포그래피를 더하는 방식 말입니다. 어떤 사람들은 PocketMod를 "zines"라고 부르는데, 이는 A4 용지 한 장으로 만들 수 있는 8페이지짜리 작은 책자이기 때문입니다.

그리고 실제로 가능했습니다! 덕분에 다음과 같은 것을 빠르게 만들기 쉬워졌습니다. [주간 계획 미니 책자](https://www.overleaf.com/read/zfzcxygqwqsq) 또는 작은 [그림 동화책](https://www.overleaf.com/read/rppnsfgnrhsf). 네, 딸아이가 자기 그림으로 만든 동화책을 보는 것을 아주 재미있어했는데… 글쎄요, 딱 10분 동안이었습니다!  [`markdown 패키지`](http://www.ctan.org/pkg/markdown) 를 사용하면 각 마크다운 문법이 LaTeX로 어떻게 렌더링될지 사용자 지정할 수 있어서, 표준 `![](img_file "캡션")` 문법을 다시 정의해 캡션이 이미지 파일 아래에 오도록 했습니다(“Figure” 접두사나 번호 없이). 그리고 페이지 나눔을 삽입했습니다. 이로써 그림책을 만드는 일이 훨씬 쉬워졌습니다. 책자를 접는 방법을 보여 주는 영상은 다음과 같습니다:

{% embed url="<https://www.youtube.com/embed/IAb31rIeGZo>" %}

### 간단한 요리 책자

생각해 보면, 레시피는 목록들로 이루어져 있습니다: 재료 목록, 준비 또는 조리 지침 목록, 그리고 어쩌면 메모 목록(조리 시간, 인분 수 등)도 있죠. 그러니 이것을 쓰는 대신:

```latex
\begin{enumerate}
\item 먼저 이것을 한다
\item 그런 다음 저것을 한다
...
\end{enumerate}
```

저는 확실히 이렇게 쓸 수 있으면 좋겠습니다:

```
#. 먼저 이것을 한다
#. 그런 다음 저것을 한다
```

그리고 재료 목록도 마찬가지입니다:

```
- 계란 2개
- 소금 한 꼬집
```

그러니 간단한 레시피를 쉽게 만들기 위해 이렇게 쓸 수 있습니다:

```
# 스크램블 에그

조리 시간
: 5분

인분 수
: 1

## 재료
- 계란 4개
- 버터 1작은술
- 우유 1/4컵
- 소금, 후추(기호에 따라)

## 조리 방법

#. 계란, 우유를 푼다...
#. 팬에 버터를 녹인다...
#. ...
```

음, 괜찮아 보입니다. Overleaf의 몇몇 사람들(그리고 그들의 가족들)이 각자의 좋아하는 빠른 레시피(처음 요리하는 사람에게 이상적)를 기여해 주었고, 저는 이에 맞춰 작은 [빠른 레시피 템플릿](https://www.overleaf.com/read/gscqdhnwzsfg) 을 만들었는데, 마크다운으로 작성할 수 있습니다 *및* 미니 책자로 만들 수 있습니다.

[![A recipe booklet produced on Overleaf using markdown](/files/85039453795d563a5fe92895ce5ed11fe58cc1b6)](https://www.overleaf.com/read/gscqdhnwzsfg)

이제 또 다른 재미가 시작됩니다. 내부적으로는 여전히 LaTeX이므로, 섹션 제목, 글머리표 목록, 글꼴 등 여러 요소를 평소의 LaTeX 요령을 사용해 계속 스타일링할 수 있습니다. 바로 그때 저는 꽤 몰두하게 되었고 다음을 만들어 냈습니다. *세 가지* “테마”를 `simple-recipe` 클래스용으로!

### 보너스 1: markdown 패키지를 사용할 때의 몇 가지 주의점

* SyncTeX은 제대로 작동하지 않습니다. Overleaf에서는 이것이 "미리보기에서의 위치" 및 "미리보기에서 클릭해 소스로 이동" 작업이 `마크다운` 영역에서 작동하지 않음을 의미합니다.
* `\\` 는 원래의 의미를 잃습니다. 일반적인 "두 칸 공백 뒤에 새 줄" `마크다운` 요령은 여기서는 작동하지 않습니다. 끝 공백이 Lua 파서에 의해 제거되기 때문이며, 이는 [`마크다운` 패키지 문서](http://texdoc.net/pkg/markdown). `\newline` 문서화되어 있습니다. 그래도
* 같은 줄에 여러 개의 밑줄 문자가 있으면 주의하세요. 다음과 같은 경우 문제가 될 수 있습니다:

  * 수식에서 아래첨자를 많이 사용한다면(팁: 그런 경우에는 `마크다운` 환경을 벗어나세요);
  * BibTeX 키에 밑줄을 사용하고 싶을 때.

  설정할 수 있습니다 `underscores=false` 최신 `markdown 패키지` 파일과 함께 사용하면 아래첨자 밑줄이 작동하도록 할 수 있지만, BibTeX 키의 밑줄은 여전히 작동하지 않습니다.

  **업데이트** (2017년 5월 13일): BibTeX 키의 밑줄은 `마크다운` v2.5.2부터 작동합니다—Vít 고마워요!
* 문자 그대로의 해시 문자도 표시하는 데 약간 어려움이 있을 것입니다. 왜냐하면 `\#` 도 작동하지 않기 때문입니다! 저는 보통 새 명령을 정의해서 그걸 대신 사용합니다.

### 보너스 2: 업데이트된 markdown 패키지의 새로운 기능

`마크다운` v2.4 이후로는 정말 멋진 문법 몇 가지를 지원하게 되었습니다:

* **인라인 각주 문법**: `...^[이것이 각주입니다]` (다음이 필요합니다 `inlineFootnotes` 옵션)
* **인용:**`[@smith1990]` (다음이 필요합니다 `인용` 옵션도 필요합니다. 또한 BibTeX 키의 밑줄도 주의하세요!)
* **펜스 코드**: 틸드 `~` 또는 백틱 `` ` `` 을 펜스로 사용할 수 있습니다.

```
~~~~
int main() {
  cout << "Hello world!";
  return 0;
}

~~~~
```

이 새로운 기능들을 사용하고 싶다면, 다음의 업데이트된 버전을 업로드하세요. `markdown.lua`, `markdown.tex` 및 `markdown.sty` 를 프로젝트에—아니면 그냥 다음에서 새 프로젝트를 만들 수도 있습니다 [이 템플릿](https://www.overleaf.com/read/whdrnpcpnwrm).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ko/in-depth-articles/32-markdown-into-latex-with-style.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.