[R] 마크다운 (Markdown) 사용법

마크다운? 

• 마크다운(markdown)은 일반 텍스트 문서의 양식을 편집하는 문법입니다. README 파일이나 온라인 문서, 혹은 일반 텍스트 편집기로 문서 양식을 편집할 때 쓰입니다. 또한 R 에서는 마크다운에 R 언어와 Python 등의 프로그래밍 언어를 사용하여 자동화 문서를 만들거나 상호작용이 가능한 문서를 만들수도 있습니다. 마크다운을 이용해 작성된 문서는 쉽게 HTML, PDF, DOC 등 다른 문서형태로 변환이 가능합니다.

• 마크다운의 장점은 간단한 명령어들로 문서의 구조를 구축하기 쉬우며 들인 노력에 비해 매우 세련되고 깔끔한 결과물을 얻을 수 있다는 점 입니다.

알아둘 것 

• 마크다운 언어에서는 html 처럼 enter 키가 작동하지 않습니다. 줄바꿈을 하기 위해선 띄어쓰기를 2회 반복합니다.

Header 

• html 에서 h1, h2, h3, h4 등의 태그로 구현되는 내용들을 마크다운에서는 # 의 반복으로 간단하게 나타낼 수 있습니다.

• 장, 절, 항, 목 등의 구분을 하고 싶을 때 header 태그를 사용할 수 있습니다. 메모장이 아닌 대부분의 markdown 에디터에서는 이렇게 헤더를 구성해놓으면 목차가 자동으로 만들어 집니다. 위의 예시는 다음처럼 목차를 구성합니다.

Emphasis 

• bold 체나 italic 체를 사용하기 위해서는 * 문자를 원하는 텍스트의 앞 뒤에 붙여서 표현합니다. bold 체의 경우에는 *를 2번 앞 뒤에, italic 체의 경우에는 *를 1번 앞 뒤에 붙여 표현합니다.

Strikethrough 

• 취소선은 ~ 기호를 이용하여 표현합니다. ~ 기호를 2회씩 앞 뒤로 반복하여 나타냅니다.

Blockquote 

• 인용문은 > 기호를 이용해서 표현합니다. > 기호를 중첩하면 중첩된 인용문을 나타낼 수 있습니다.

Horizontal Line 

• html 에서 <hr> 태그로 표현되는 수평선은 마크다운에서는 *** 이나 --- 혹은 ___ 로 표현할 수 있습니다.

Bulleted List & Numbered List

• List 는 점 리스트와 숫자 리스트 두가지가 있습니다. 점 리스트는 + 나 -, * 를 사용해서 표현할 수 있고 숫자리스트는 숫자와 . 을 이용해서 표현합니다.

• Bulleted List - 점 리스트는 + 나 -, * 를 통해 표현 합니다. 띄어쓰기 2회와 함께 기호를 사용하면 안쪽으로 들어간 List 를 표현할 수 있습니다.

• Numbered List - 숫자 리스트는 숫자와 . 을 통해 나타냅니다. 원하는 숫자를 기술한 뒤 . 을 입력하면 리스트로 변경됩니다.

Code Block 

• Code Block 태그는 글을 네모형태의 테두리 안에 넣어 강조할 때 사용합니다. 일반적으로 프로그램 코드를 본문과 불리할 때 사용합니다. Code Block 은 Inline block 과 fenced block 두 가지로 구분할 수 있습니다.

• Inline 코드 블록은 본문 내부에 블록을 삽입할 때 사용합니다. ` 기호를 원하는 문자열 앞 뒤에 입력하면 됩니다. ` 기호는 작은 따옴표가 아닌 키보드에서 숫자 1 옆에 있는 기호 입니다.

• Fenced 코드 블록은 본문과 구별되는 사각형 테두리를 만드는 블록입니다. ` 기호를 3회 반복하여 문자열 앞 뒤에 입력하면 Fenced 코드 블록을 입력할 수 있습니다.

Table 

• 마크다운 에서 Table 은 | 와 - 기호로 간단하게 만들 수 있습니다.

• | 기호가 열을 구분해 주며 | 기호 사이에는 원하는 내용을 입력하면 됩니다. 또한 _ 기호는 header 를 표시할 때 사용하는데 (1,1) , (2,1) , (3,1) 밑에 _ 기호가 있기 때문에 bold 체로 표현되는 것을 확인할 수 있습니다.

더 쉽게 마크다운을 작성하고 싶다면? 

• 에디터를 사용해서 더 쉽게 마크다운을 작성할 수 있습니다. 저같은 경우에는 R Studio 와 Typora 라는 프로그램을 이용해서 마크다운을 작성합니다.

• Rmd 파일이 필요하신 게 아니라면 Typora 에디터를 추천합니다.

2018/04/30 - [R/RMD (R markdown)] - [markdown editor] typora - A TRULY MINIMAL MARKDOWN EDITER

---

부족한 블로그에 방문해 주셔서 감사합니다.

잘못된 부분이나 질문이 있으시면 

댓글로 말씀해주세요.

금방 확인하고 피드백 드리겠습니다.

좋은 하루 되세요. ^^