Git 블로그 글 작성 방법 / 마크다운 문법
Git 블로그 글 작성 방법
_posts 폴더에 YYYY-MM-DD-제목.md 파일 생성후 포스트 front matter를 아래와 같이 작성합니다.
---
title: "글제목"
excerpt: ""
categories:
- 카테고리제목
tags:
- []
permalink: /카테고리URL/글URL
toc: true
toc_sticky: true
date: YYYY-MM-DD
last_modified_at: YYYY-MM-DD
---
이 아래로 마크다운 문법을 이용해 글을 작성하시면 됩니다.
마크다운 문법
제목
# 제목 H1
## 제목 H2
### 제목 H3
#### 제목 H4
##### 제목 H5
###### 제목 H6
Git 블로그 글 제목이 H1이기 때문에, 글 본문에는 H2부터 사용하는 것이 좋습니다.
블럭 인용 문자
> 인용문 1
> > 인용문 2
같은 > 뎁스로 문단을 묶고, 좌측에 세로 포인트를 줄 수 있습니다.
목록
순번 목록
1. 첫번째
2. 두번째
3. 세번째
들여쓰기가 있는 순번 목록을 만들 수 있습니다.
점 목록
- 1뎁스 (검은 점)
- 2뎁스 (하얀 점)
- 3뎁스 (검은 네모 점)
* 또는 + 또는 -으로 점 목록을 표시할 수 있으며, 모두 동일하게 표현됩니다.
줄바꿈
띄어쓰기 2번 또는 <br>으로 줄을 바꿀 수 있습니다.
코드 블럭
```
public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Honeymon");
}
}
```
아래처럼 html, javascript, css, bash, java, cpp, yml 등 언어를 명시하면 더 이쁘게 문법이 강조됩니다.
```java
public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Honeymon");
}
}
```
수평선
---
또는 <hr>으로 수평선을 그려서 페이지를 나눌 수 있습니다.
글자 강조
강조는 블로그 커스텀에 따라 다르게 표현될 수 있습니다.
BOLD
**굵은글씨**
취소선
~~취소선~~
밑줄
<u>밑줄</u>
회색형광펜
`회색형광펜`
밝은형광펜
<mark>밝은형광펜</mark>
링크
현재 탭 링크
<https://URL>
새 탭 링크
<https://URL>{: target="_blank"}
텍스트 링크
[대체텍스트](https://URL)
[대체텍스트](https://URL){: target="_blank"}
하이퍼링크를 대체텍스트로 보여줄 수도 있습니다.
이미지
포스트에 사용할 이미지는 /assets/images/posts_img/글제목 폴더에 저장합니다.
이미지
위 문법 사용 시 이미지 사이즈는 자동 조정되어 표현됩니다.
링크 이미지
](https://URL)
이미지 클릭 시 URL 링크로 이동합니다.
이미지 크기 조절
<img src="/폴더/이미지명.jpg" width="50%" height="30%" alt="이미지설명"/>
img 태그를 사용하면 이미지 크기를 직접 조절할 수 있습니다.
표
| 제목1 | 제목2 | 제목3 |
| :-- | :--: | --: |
| 좌측정렬 | 중앙정렬 | 우측정렬 |
| 송 | 하 | 영 |
위 마크다운 문법으로 테이블을 만들면 열 병합이 어렵기 때문에, 아래처럼 table 태그를 이용하면 좋습니다.
<table>
<thead>
<th>제목1</th>
<th>제목2</th>
<th>제목3</th>
</thead>
<tbody>
<tr>
<td rowspan="2">열 병합</td>
<td colspan="2">행 병합</td>
</tr>
<tr>
<td>하</td>
<td>영</td>
</tr>
</tbody>
</table>
테이블 자동 생성 사이트
http://www.tablesgenerator.com/html_tables
요소 묶기
┌ `요소1`
├ `요소2`
├ `요소3`
└ `요소4`
마크다운 미리보기
VSCode로 미리보기
VSCode를 이용하면 글 작성 중에도 마크다운을 미리보기 할 수 있습니다.
VSCode에서 .md 파일을 열고 우측 상단의 Open Preview to the Side 아이콘을 클릭합니다.
좌측 창에서 글을 수정하면 Git에 올리지 않고도 우측 창에서 마크다운을 미리 볼 수 있습니다.
옵시디언으로 미리보기
옵시디언 앱을 설치하면 모바일로도 마크다운 글을 작성할 수 있습니다.
드롭박스 연결하여 동기화할 수 있고, 작성한 마크다운 텍스트를 옮기는 방법도 있습니다.
Git 블로그 글 업데이트
Build 옵션이 Deploy from a branch 이면, Git push 시 build 시작하여 몇 분 내로 글이 반영됩니다.
마지막 deployed 시간 확인 방법
깃허브 로그인 > Your repositories > Git 저장소 선택 > Settings > 상단 ‘Last deployed by 저장소’ 시간 확인
빌드 실패 원인 확인
깃허브 로그인 > Your repositories > Git 저장소 선택 > Actions > All workflows에서 실패한 빌드 선택 > build 클릭 > build 실패 에러메세지 확인
마크다운 글에 {가 연속하여 2개 이상 있으면 Jekyll 빌드 실패가 됩니다.
Leave a comment