> 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/30-how-to-write-in-markdown-on-overleaf.md). # Overleaf에서 Markdown으로 작성하는 방법 **발행 후 업데이트** (2017년 5월 13일 추가): 원문 기사에 관한 몇 가지 유용한 피드백을 보내주신 Vít Novotný, 그 `markdown` 패키지에 대해 저희에게 편지를 보내주셔서 감사드립니다. 우리는 그의 조언과 제안을 반영하고 포함한 이 업데이트된 버전을 기쁘게 공개합니다. ### 엥, 뭐라고? [Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) 는 가벼운 마크업 언어로(이해되시나요? 😉) 일반 텍스트로 어떤 내용을 몇 가지 *매우* 간단한 규칙만으로 작성한 뒤, 이를 HTML 같은 형식화된 출력물로 변환할 수 있게 해줍니다. 소프트웨어 개발자와 프로그래머들 사이에서 매우 인기가 있는데, 바로 그 단순함 때문입니다(그리고 덧붙이자면, 메모를 남기기에도 완벽합니다!). 예를 들어, 빠른 장보기 목록을 작성하려면: ``` # 식료품 목록 *기억하세요* 다가오는 [세일](http://acme-marg.com) 기간에 가능한 한 많이 챙기세요! ## 음식 - 구운 콩 - 스파게티 ## 문구류 - 메모장 - 연필 ``` 그리고 pandoc 같은 도구를 사용하면 HTML 출력으로 얻을 수 있습니다. [pandoc](http://pandoc.org/): ```html

식료품 목록

기억하세요 다가오는 세일 기간에 가능한 한 많이 챙기세요!

음식

문구류

``` 좋고 간단합니다! Markdown의 다른 문법도 찾을 수 있습니다 [여기](https://daringfireball.net/projects/markdown/syntax). ### 그렇다면 이것이 저에게는 무슨 의미일까요? 많은 LaTeX 사용자는 아름답게 조판된 LaTeX 문서에 만족하지만, Markdown 사용자들을 보면 부러움을 느끼지 않을 수 없습니다. 왜냐하면, LaTeX 마크업은 *수* 때때로 꽤 장황해지기 때문입니다. 네, 목록들 말입니다. 바로 여러분을 보고 있습니다 *여러분*... 좋은 소식은 훌륭한 새 [`markdown` LaTeX 패키지](https://ctan.org/pkg/markdown) 를 사용하면 LaTeX 문서에서 markdown 문법을 쓸 수 있고(즉, 입력은 더 단순해지고) 그래도 아름답게 조판된 PDF를 얻을 수 있다는 것입니다! 필요한 것은 `markdown` 패키지를 문서에 불러오고, Markdown 자료를 하나의 `markdown` 환경: ```latex \documentclass{article} \usepackage{markdown} \begin{document} \begin{markdown} # 식료품 목록 *기억하세요* 다가오는 [세일](http://acme-marg.com) 기간에 가능한 한 많이 챙기세요! ## 음식 - 구운 콩 - 스파게티 ## 문구류 - 메모장 - 연필 \end{markdown} \end{document} ``` 또는 Markdown 자료를 하나의 `*.md` 파일: ```latex \documentclass{article} \usepackage{markdown} \begin{document} \markdownInput{example.md} \end{document} ``` 멋지네요! 이는 아마 개발자 유형의 사람들을 매우 기쁘게 할 텐데, 이제 그들은 자신의 `.md` 문서! ### Markdown을 작성해도 여전히 LaTeX 명령을 사용할 수 있나요? 예, Markdown 자료 안에서도 여전히 LaTeX 명령을 사용할 수 있습니다! 단지 `hybrid` 옵션을 `markdown`: ```latex \usepackage[hybrid]{markdown} ... - 메모장(표지에 큰 $E=mc^2$가 적힌 종류) ``` ### 리터럴 문자 '#'와 '\_'(밑줄)는 어떻게 사용할 수 있나요? #### '#' 입력하기 '#' 문자를 입력할 수 없습니다 *안의 `markdown` 환경*. 심지어 `\#` 도 작동하지 않습니다. 다음과 같은 명령을 정의해야 합니다 `\newcommand{\texthash}{\#}`, 그런 다음 `\texthash` 당신의 `markdown` 환경에서 사용해야 합니다. 밑줄도 마찬가지이며, 특히 같은 줄에 둘 이상 있을 때, 예: `$y = m_1 + n_2$`. 때로는 현재의 `markdown` 환경을 끝내고 문제되는 줄을 일반 LaTeX 모드로 작성한 다음, 다른 `markdown` 환경 안에서. #### '\_'(밑줄)과 '\`'(백틱) 입력하기 **업데이트** (2017년 5월 13일 추가): `markdown` version 2.5부터는 `underscores = false` 및 `codeSpans = false` 를 설정하여 밑줄과 백틱을 비활성화할 수 있습니다. 그러면 이스케이프 없이 하이브리드 모드에서 수학 아래첨자와 따옴표를 쓸 수 있습니다. 강조에는 별표를 사용하므로, 정말로 잃게 되는 것은 인라인 코드 예제뿐입니다. 팁을 알려주신 Vít에게 감사드립니다! #### 피해야 할 환경... 그리고 백틱으로 인라인 verbatim을 쓰거나, 줄을 네 칸 들여써서 verbatim 블록을 만들 수는 있지만, `lstlisting` 도 `minted` LaTeX 환경을 `markdown` 환경 안에서 사용하지 마세요. 그냥 하지 마세요. #### markdown 환경에서 HTML 사용하기 그리고 아니요, LaTeX `markdown` 환경 안에서는 HTML을 사용할 수 없습니다(일반적인 Markdown에서는 흔히 하는 일이지만). 죄송합니다. **업데이트** (2017년 5월 13일 추가): `markdown` v2.3부터는, `html` markdown 자료에 HTML 태그가 포함되어 있어도 그대로 표시하지 않는 옵션이 있습니다. 다만 태그 내용 자체를 실제로 서식화하지도 않습니다—즉, `안녕하세요!` 는 그냥 일반 굵기인 안녕하세요!로 표시됩니다. 하지만 HTML 엔티티는 `©` 와 같은 HTML 엔티티는 ©로 렌더링됩니다. 이것을 알려주신 Vít에게 감사드립니다. ### 권장하는 markdown 패키지 옵션 유용하다고 여길 수 있는 `markdown` 패키지 옵션 한 세트는 다음과 같습니다: ```latex \usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown} ``` 이 옵션들은 다음의 사용을 활성화합니다 * 각주 markdown 문법(예: `[^1]`); * 정의 목록과 `#` 번호 매기기 목록용 * "올바른" 줄임표(…). 다음은 [완전한 예제](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) Overleaf 갤러리에 있으며, 여기에 [또 다른 예](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw). ### 하이퍼링크와 각주: 어떻게? Overleaf 예제에서는 하이퍼링크가 각주입니다. 어떻게 해야 hyperref 하이퍼링크가 되나요? `markdown` 는 사용자 정의가 가능하므로, 서로 다른 요소를 어떻게 렌더링할지 정할 수 있습니다. 프리앰블에 이것들을 추가하면 그대로 됩니다: ```latex \markdownSetup{renderers={ link = {\href{#2}{#1}} }} ``` **업데이트** (2017년 5월 13일 추가): `rendererPrototypes` 는 초기 버전에서 사용되었습니다. 일반 사용자에게는 `renderers` 를 자신의 정의에 사용하는 것이 권장됩니다. `rendererPrototypes` rendererPrototypes `rendererPrototypes`를 수정하면 다른 패키지가 당신의 설정을 덮어쓸 위험이 있습니다. 이것을 알려주신 Vít에게 감사드립니다! ### 이미지 포함하기(2022년 11월 8일 업데이트) * **참고**: 다음 예제에서는 그래픽 파일을 사용합니다(`example-image.pdf`)을 제공하는 `mwe` 패키지입니다. 이러한 그래픽 파일은 TeX Live와 함께 배포되므로 Overleaf 서버에 저장되며, 아래 예제와 같은 이미지 자리표시자로 사용할 수 있습니다. 다음 형식의 마크업을 작성하면 마크다운에 이미지를 포함할 수 있습니다: ```latex ![대체 텍스트](파일 이름 "이미지 캡션") ``` 아마도 매개변수 이름 `대체 텍스트`, `파일 이름` 및 `"이미지 캡션"` 이들이 무엇을 하는지 설명합니다. 다음은 이를 보여 주는 예제입니다: ```latex \documentclass{article} \usepackage[hybrid]{markdown} % mwe 패키지는 예제 이미지를 제공합니다. 이를 불러오는 것은 % 필수는 아닙니다. 그 이미지들은 LaTeX의 검색 경로에 있기 때문입니다. % 여기서는 예제에서의 명확성을 위해 이를 불러옵니다. \usepackage{mwe} \begin{document} \begin{markdown} 이 예제는 그래픽 파일을 가져오는 방법을 보여 줍니다. 여기서는 `mwe` 패키지가 제공하는 예제 이미지를 사용하고 있습니다. % 이미지 표시 크기를 바꿔야 한다면 \setkeys{Gin}을 사용하세요 \setkeys{Gin}{width=.5\linewidth} ![내 이미지를 설명하는 대체 텍스트입니다.](example-image.jpg "\texttt{mwe} 패키지가 제공하는 예제 이미지.") \end{markdown} \end{document} ``` [이 예제를 Overleaf에서 열기.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) 이 예제는 다음과 같은 출력을 생성합니다: ![마크다운에서 이미지를 가져오는 방법 보기](/files/2825dc60a0b1482b047fd113877a6155d3703f1c) #### 이미지 너비에 대한 참고 대부분의 패키지와 마찬가지로 `markdown` 다른 패키지도 불러오는데, 다음을 포함합니다 [`keyval`](https://ctan.org/pkg/keyval?lang=en) 및 [`graphicx`](https://ctan.org/pkg/graphicx?lang=en)등이 제공하는 명령과 기능을 활용하기 위해서입니다. 여기서는 이미지 너비가 다음을 사용해 설정됩니다. `\setkeys` 명령으로, 다음에서 제공됩니다 `keyvals`. `Gin` 는 다음이 정의한 키의 "family"입니다 `graphicx` 패키지. * **참고**: LaTeX 명령, 여기서는 `\setkeys`이 사용되므로 *안에서* 그 `markdown` 환경에서, 다음의 `hybrid` 옵션이 필요합니다. #### float 배치 지정자 변경하기(더 고급) 그림 포함을 위한 markdown 문법은 float 배치 지정자를 직접 지정할 수 있게 해주지는 않지만, 그림이 렌더링되는 방식을 재정의하여 조정할 수 있습니다: ```latex \markdownSetup{renderers={ \begin{figure}[hbt!] \centering \includegraphics{#3}% \ifx\empty#4\empty\else \caption{#4}% \fi \end{figure}} }} ``` 자세한 내용은 [markdown 문서](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html). ### LaTeX에서 markdown으로 표를 만들 수 있나요? 😀 안타깝게도, 불가능합니다. 표는 [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) 에서만 지원되며, LaTeX `markdown` 패키지는 현재 이를 지원하지 않습니다. **업데이트** (2017년 5월 13일 추가): Vít의 팁에 따르면, `contentBlocks` 구문 확장을 version 2.4부터 사용하거나, `inputFencedCode` 렌더러를 조정하여 일부 CSV 형식 텍스트를 빠르게 표로 바꿀 수 있습니다. ### markdown 패키지의 더 많은 유용 기능...? 앞서 언급했듯이, 이것은 메모를 남기기에 멋진 방식이며, 몇 가지 멋진 LaTeX 문서 클래스나 패키지 설정과 결합하면 강의가 끝날 때 그 자체로 아름다운 노트북을 갖게 해줍니다. 예를 들어, [Tufte 클래스](https://www.overleaf.com/gallery/tagged/tufte): ```latex \documentclass{tufte-handout} \usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown} \begin{document} \markdownInput{PHY303-lecture-12Nov2016.md} \end{document} ``` 그리고 목록 쓰기를 훨씬 더 편리하게 만드는 짧고 간단한 문법 덕분에 이제 우리는 *정말 빠른* 작성 방식 [Beamer 발표](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) 및 [포스터](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)! 즐기세요! --- # 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/30-how-to-write-in-markdown-on-overleaf.md?ask=&goal= ``` `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.