게시글 파일 만들기
- _post 폴더로 이동한다.
- yyyy-mm-dd-title.md 형식의 파일을 만든다.
게시글 작성 과정
- 파일 생성
- 머릿말 작성
- 본문 작성
머릿말 작성 방법
- 위아래의 — 사이에 작성한다.
- 필요한 각 요소들을 작성한다.
- layout
- 레이아웃 파일명 (확장자 제외)
- 레이아웃 파일은 반드시 _layouts 디렉토리에 존재해야 한다.
- title
- 게시글 제목
- 기본값 : 파일명에 있는 title 위치
- excerpt
- 게시글 목록에서 보여지는 게시글 소개
- date
- 게시글 작성 날짜
- categories
- 게시글의 카테고리
- 카테고리끼리 띄워서 쓰면 계층형 구조가 된다.
- 같은 이름을 쓰면 한 번만 쓴 거로 취급된다.
- tags
- 태그 목록
- 대괄호 안에서 쉼표로 구분해서 작성한다.
- 작성했는데도 표시가 안 되면 별도 설정이 필요하다.
- toc
- true로 값을 주면 포스트의 헤더들만 보여주는 목차가 나타난다.
- toc_sticky
- true로 값을 주면 목차가 스크롤에 따라서 움직인다.
- published
- false로 설정하면 해당 게시글이 노출되지 않는다.
- comments
- false로 설정하면 해당 게시글의 댓글이 나타나지 않는다.
- mermaid
- true로 설정하면 해당 게시글에서 mermaid js를 쓸 수 있다.
- pin
- true로 설정하면 해당 게시글을 홈페이지 메인 화면에 고정할 수 있다.
- 포스팅 날짜가 최근일 수록 위로 올라온다.
- true로 설정하면 해당 게시글을 홈페이지 메인 화면에 고정할 수 있다.
- layout
사용자 정의 변수
- 머릿말 쪽에서 변수를 설정하면 본문에서 Liquid로 사용할 수 있다.
본문 작성 방법
줄바꿈
- <br/> 태그 추가
- 문장 끝에 공백 2개 이상 추가
\
추가- 블록 인용구에서 가능
\
뒤에 아무것도 입력하지 않아야 한다.
블록 인용구
>
를 앞에 붙인다.- 다중 인용구를 사용할 때는 깊이만큼
>
의 개수를 앞에 붙인다.
인라인 코드
\
` 사이에 내용을 입력한다.
코드 블럭
기본 형식
```사용할_언어
코드 내용
```
사용 예시
```java
public class Member {
String name;
}
```
1
2
3
public class Member {
String name;
}
링크
기본 형식
[링크텍스트](링크)
새창으로 넣기
[링크텍스트](링크){:target="_blank"}
{}
사이에 html 요소를 지정할 수 있다.
이미지
기본 형식
![설명](링크)
사용 예시
![설명](링크){:style="border:1px solid #eaeaea; border-radius: 7px; padding: 0px;" }
{}
사이에 html 요소를 지정할 수 있다.
중첩 리스트 사용하기
1
2
3
- 1단계
- 2단계
- 3단계
순번 리스트 사용하기
1
2
3
1. 첫번째
2. 두번째
3. 세번째
복합 리스트 사용하기
1
2
3
4
5
6
1. 첫번째
- xxx
- xxx
- xxx
2. 두번째
3. 세번째
마크다운 문법 보여주기
\<b>예시</b>
예시가 <b>예시</b>처럼 보이게 된다.
제목 붙이기
- #을 추가한다.
- 1개에서 6개까지 쓸 수 있다.
- 개수가 많을 수록 하위 단락의 제목이 된다.
- 설정에 따라 어느정도 차이는 있지만
제목을 붙이는 방식에 따라서
목차에 나오는 목록이 달라진다.
텍스트 강조
**강조할 텍스트**
텍스트 기울임
*기울일 텍스트*
텍스트 강조 + 텍스트 기울임
***강조하고 기울일 텍스트***
취소선
~~취소선 그을 텍스트~~
밑줄
<u>밑줄 그을 텍스트</u>
체크리스트
기본 형식
1
2
- [ ] 체크 없는 박스
- [X] 체크 있는 박스
사용 예시
- 체크 없는 박스
- 체크 있는 박스
구분선
***
또는 ---