깃허브 블로그 포스팅을 위한 마크다운 문법공부
깃허브 블로그 사용을 위한 포스팅 가이드 노트
블로그 포스팅 .md 확장자 이용방법
게시 파일 양식
게시글은 _posts 계층에 .md확장자 파일을 넣어 포스팅 가능하다.
jekyll파일 안 .../_posts/yyyy-mm-dd-'titlename'.md 양식으로 파일 생성
ex)
.../_post/2021-07-03-HelloWorld.md
.../_post/2021-07-03-posting.md
머릿말(Front-Matter) 설정 방법
먼저 맨위에 타이틀을 정하고 내용을 써 내려갑니다.
그리고 본문 내용은 # 을 이용하여 작성.
---
layout: single
title: TITLE
---
안녕하세요 이건 본문
내용입니다
이런식으로 머릿말(Front-Matter)을 작성해주면 됩니다.
*--- ... ---*여기 …부분에 머릿말과 그 내용들을 채워주면 됩니다.
개인적으로 사용하면서 작성하면 좋은 머릿말
- title : 블로그에서 포스트 제목을 보여주는 부분이므로 필수적으로 작성해주시길 바랍니다.
- excerpt : 블로그 제목 밑 내용 미리보기를 보여줄 내용을 적는 곳입니다. 만약 추가하지 않는다면 포스팅 내용이 표시 됩니다.
- date : 블로그 작성 날자를 표시합니다. 하지만 포스팅 파일에 이미 yyyy-mm-dd.md 형식으로 작성 됐으므로 굳이 필요없습니다.
- last_modified_at : 마지막 수정일자를 작성해주는 부분
이 외에도 여러가지 변수들이 있으니 필요하다면 찾아서 작성하시길 바랍니다.
포스팅 내용은 마크다운(markdown) 문법으로 작성
머릿말 이후 본문 내용은 마크다운 문법으로 작성한다. HTML도 지원한다고 하지만 jekyll에경우 마크다운이 훨신 간단해서 사용한다고 한다.
마크다운이 자료도 많고 찾기도 편하니 이 문법을 사용하시길 바랍니다.
쉽고 편하게 마크다운 편집 및 포스팅
일반적으로 마크다운을 작성해 나간다면 미리보기도 없고 글자 효과, 삽입, 레이아웃 설정이 힘들수밖에 없다. 하지만 이는 외부 프로그램을 사용한다면 쉽게 해결할수 있습니다. 비쥬얼 스튜디오로도 확장 프로그램으로 가능합니다. 저는 타이포라(Typora)를 사용합니다.
타이포라에 경우 내용 작성시 미리보기가 바로 적용되어서 직관적인 작성에 용이합니다. 추가로 한글문서 작성하는것 처럼 우클릭으로 레이아웃, 삽입내용, 글자 속성 등 여러가지를 적용가능해서 편합니다.
21/07/23
Leave a comment