Jekyll 테마 마크다운 문서 쓰는법

Goraniworks / April 2024 (365 Words, 3 Minutes)

Jekyll 테마를 이용한 깃허브 블로그에서 마크다운으로 문서 작성하기

깃허브 블로그와 Jekyll 테마를 이용하면 문서를 마크다운(Markdown) 형식으로 작성할 수 있습니다. 마크다운은 텍스트 기반의 가벼운 마크업 언어로, 쉽고 빠르게 웹 콘텐츠를 작성하고 서식을 지정할 수 있습니다. 깃허브 테마를 설치하니 좋은 마크업 언어 설명 포스트가 있어 번역하고 나만의 몇가지 사항을 추가하여 작성했습니다.

참고한 페이지 : https://www.abhinavsaxena.com/moonwalk/overview-post

마크다운의 기본 요소들

제목 (Headings)

• # 하나는 가장 큰 제목을 나타냅니다 (h1 태그와 동일).
• ## 두 개는 부제목을 나타냅니다 (h2 태그와 동일).
• ###### 여섯 개까지 사용하여 작은 제목을 만들 수 있습니다.

목록 (Lists)

• 순서 없는 목록은 - 또는 * 를 사용하여 작성합니다.
• 표시 뒤는 한칸 띄고 씁니다. 안띄고 쓰면 아래줄과 자동으로 연결됩니다.

- 민지
- 하니
- 다니
- 해린
- 혜인

• 민지
• 하니
• 다니
• 해린

• 혜인

• 순서 있는 목록은 다음과 같이 숫자를 사용하여 작성합니다.

1. 민지
2. 하니
3. 다니
4. 해린
5. 혜인

1. 민지
2. 하니
3. 다니
4. 해린
5. 혜인

수평선 (Horizontal Rules)

• 세 개의 하이픈 ---을 사용하여 수평선을 만듭니다.

  ---
  

  ---

코드 (Code)

• 백틱(```) 세 개를 사용하여 코드 블록을 만듭니다.
• 백틱은 키보드 ESC버튼 아래, Tab키 위에 위치한 버튼입니다.
• 인라인 코드는 백틱 한 개(`)로 감싸서 작성합니다.

코드 예제입니다:

const ultimateTruth = 'follow middlepath';
console.log(ultimateTruth);

이렇게 코드를 강조한 형식을 ‘인라인 코드’inline code라고 합니다.

인용문 (Blockquotes)

• > 기호를 사용하여 텍스트를 인용문으로 만듭니다.

  > 이것은 인용문입니다.
  

이것은 인용문입니다.

문장 강조

문장을 별표 두개로 감싸면 문장이 강조되요
**문장을 별표 두개로 감싸면 문장이 강조되요**

문장을 별표 두개로 감싸면 문장이 강조되요 문장을 별표 두개로 감싸면 문장이 강조되요

표 (Tables)

• | 기호를 사용하여 열을 정의하고, : 기호를 사용하여 텍스트 정렬을 지정합니다.
• 한글은 문제가 있습니다. 영어로 작성하세요.

| table          | is            | cool   |
| ------------   |:-----------:  | ------:|
| col 3 is       | right-aligned | $1600  |
| col 2 is       | centered      | $12    |
| col 1 is       | left-aligned  | $1     |

이미지 (Images)

• ![대체 텍스트](이미지 URL) 형식을 사용하여 이미지를 삽입합니다.

![theme logo](assets/images/favicon/android-chrome-256x256.png)

주석

- 주석을 이렇게 답니다.[^1]
- 주석을 이렇게 답니다.[^2]
- 주석을 이렇게 답니다.[^3]

- 문서 마지막에 이렇게 설명을 써줍니다.
{: data-content="footnotes"}

[^1]: 주석1
[^2]: 주석2
[^3]: 주석3

• 주석을 이렇게 답니다.¹
• 주석을 이렇게 답니다.²
• 주석을 이렇게 답니다.³