Markdown 기초 문법
[1] 들어가기 앞서
이것부터 말합니다.
MarkDown은 MarkUp 언어와 동일하게 Java, Ruby, Javascript와 같은 프로그래밍 언어는 아닙니다.
[2] 설명
MarkUp 이란?
쉽게 말씀드리면 MarkUp은 Tag라는 것을 이용하여 문서의 구조를 명시하는 언어입니다.
우리가 많이 보던 HTML, XML, SVG 등이 해당됩니다.
(JSON, YAML 파일은 분류는 마크업으로 되어 있지만, 구조와 쓰임이 다릅니다)
MarkDown 이란?
MarkUp이 Tag를 이용한 것이라면, MarkDown은 일반 텍스트로 쓰는 마크업 언어입니다.
우리가 메모장에서 텍스트를 적는 것처럼 쓰는데, 유용한 기능이 추가된 언어라고 생각하면 편합니다.
파일의 확장자는 .md 이며, Hexo에서의 간단 사용 방식은 아래에 기술합니다.
[3] 기초적인 문법
- 글쓰기
1
2
3
4
5
6
7
8
9텍스트 적듯이 적습니다.
**해당 문장의 글씨를 두껍게, 즉 강조를 할 수 있습니다**
*이탈릭체(비스듬한 글씨체)는 이런 식으로 적습니다*
***두꺼우면서 비스듬하게 적으려면 별표를 세 번 합니다***
~~취소선은 이런 식으로 적습니다~~
<u>밑줄을 적을 수도 있습니다<u>
위의 순서대로 네 기능은 각각 __할말__ _할말_ ___할말___ ~할말~ 로 써도 가능합니다.
- 인용구
1
2
3
4
5
6
7
8
9
10
11> 텍스트 적듯이 적습니다.
>> 로 중첩된 인용문 사용 가능
>>> 로 또 중첩된 인용문 사용 가능
또는
{% blockquote %}
이런 식으로도 적습니다.
{% endblockquote %}
또한 blockquote 쪽에 [author[, source]] [link] [source_link_title] 등 여러 정보를 추가할 수 있습니다.
코드 블럭(or 블럭 내 텍스트)
3-1. 기본
1
2
3
4
5
6
7'''
텍스트 적듯이 적습니다. 단, '''을 ```로 바꾸어야 합니다.
'''
''' Python
이와 같이 특정 언어의 코드 블럭을 생성할 수도 있습니다. ex) MarkDown, Javascript, Python, Ruby...
'''3-2. Python용 코드 블럭 예시
1
2for i in range(1, 10, 1):
print(f"간단한 for문을 출력합니다. {i}번째")3-3. 아래는 bash용 코드 블럭 예시
1
$ vim ./~zshrc
- 제목(글자 크기)
1
2
3
4
5
6(<h1> 에 해당) # 제목 1
(<h2> 에 해당) ## 제목 2
(<h3> 에 해당) ### 제목 3
(<h4> 에 해당) #### 제목 4
(<h5> 에 해당) ##### 제목 5
(<h6> 에 해당) ###### 제목 6
iframe 및 타 영상 사이트
5-1. iframe
1
{% iframe URL입력 가로길이 세로길이 %}
가끔씩 youtube 처럼 연결 거부로 뜨는 사이트가 있는데, embed 태그로 가져와야 합니다. 예를 들어,
1
{% iframe https://www.youtube.com/embed/dQw4w9WgXcQ 100% 500 %} 이런 식으로 가져옵니다.
여기서 세로 길이는 100%으로 하면 매우 짧기 때문에 위와 같이 300~500을 추천합니다.
5-2. youtube
1
{% youtube dQw4w9WgXcQ %} (유튜브 비디오 ID를 입력)
그 외 여러 삽입 기능이 있으니 찾아보시는 걸 추천드립니다.
링크 삽입
6-1. 하이퍼링크
1
[유튜브](https://www.youtube.com/)
6-2. 이미지
1
![이미지 제목](/img/이미지파일.png "대체 텍스트")
위의 /img/~ 이 경로는 보통 자기가 설치한 테마 폴더가 기본 값인데, icarus 테마를 예시로 들자면,
icarus 테마 폴더 내 source 폴더에 img 혹은 image라는 폴더가 있는데, 그곳에서 가져옵니다.
테이블
7-1. 기본
1
2
3
4
5|제목|내용|설명|
|------|---|---|
|테스트1|테스트2|테스트3|
|테스트1|테스트2|테스트3|
|테스트1|테스트2|테스트3|7-2. 기능 추가
1
2
3
4
5|컬럼1|컬럼2|
|:-:|:-:|
|값1-1|값2-1|
|값1-2|값2-2|
|값1-3|값2-3|자세한 설명은 여기 참고해 주시면됩니다.
- 요약문(포스트 미리보기)
1
2
3
4미리보기에 보여질 내용
미리보기에 보여질 내용
미리보기에 보여질 내용
<!-- more -->
- 드롭다운(접히기, 펴기)
<details> <summary>접기/펼치기 버튼</summary> <div markdown="1"> 내용 </div> </details>
[4] 참고 사이트
- 마크다운 문법
- MarkDown(마크다운) 문법
- MarkDown 사용법 총정리 (적극 추천)
- Hexo 공식 문서(왼쪽 탭에서 Basic Usage 부분 열람)
- 마크다운(Markdown) 문법 - 목록(리스트), 체크박스