Written by 최태열
on December 19, 2020

Markdown 파일로 포스트 올리기

Github 블로그에 파일 손쉽게 올리기

Markdown?

마크다운(markdown)은 일반 텍스트 기반의 경량 마크업 언어다. 일반 텍스트로 서식이 있는 문서를 작성하는 데 사용되며, 일반 마크업 언어에 비해 문법이 쉽고 간단한 것이 특징이다. HTML과 리치 텍스트(RTF) 등 서식 문서로 쉽게 변환되기 때문에 응용 소프트웨어와 함께 배포되는 README 파일이나 온라인 게시물 등에 많이 사용된다.

마크다운 위키백과

우리는 Markdown으로 문서를 만들고 그것을 하나의 포스트로 Github블로그에 올릴 수 있다.

Markdown 파일 만들기

---
layout: post
title: Jekyll 테마로 Github 블로그 만들기
subtitle: Jekyll 테마 Fork
tags: [GitBlog]
comments: true
---
## Github 블로그란?

---

우리는 일반적으로 github를 사용할 때, 협업툴 및 저장소로 사용한다. 하지만 github에서는 블로그를 운영할 수 있게 github.io를 제공한다.

주로 개발자를 꿈꾸는 사람들이 본인의 포트폴리오를 만들기 위해 블로그를 운영한다.

<br>

## 시작하기

---

### Jekyll

주로 github 블로그를 만든다 하면 Jekyll을 활용해서 만드는 경우가 많다. 이 블로그도 Jekyll을 사용해 만든 것이다.

백지부터 시작하는 것은 너무 힘들기 때문에 오픈소스를 사용하자

github에는 jekyll로 만든 블로그 디자인을 무료로 공유해주는 훌륭한 사람들이 많다. 우리는 그냥 가져다가 쓰면 된다.

Github에 Jekyll을 검색하면 많은 디자인이 나온다. 거기서 원하는 디자인의 저장소를 포크해오면 된다.

Github 블로그 1편의 실제 마크다운 파일의 일부이다.

마크다운은 HTML의 문법을 사용 가능하면서 마크다운 자체의 문법도 사용할 수 있다.

마크다운 문법은 검색하면 잘 나오니 따로 언급하진 않겠다.

중요한 것은 위에 — 로 구분되어 있는 Header 부분이다.

layout: post

title: Jekyll 테마로 Github 블로그 만들기

subtitle: Jekyll 테마 Fork

tags: [GitBlog]

comments: true

layout

layout은 그 페이지에 대한 속성을 나타낸다. 블로그 디자인을 만든 사람이 몇 가지 형식의 html을 만들었고 그곳에 이 Markdown 파일의 내용을 담아서 하나의 웹페이지를 만드는 것이다. 따라서 자신의 블로그 디자인을 만든 사람의 설명에 따라서 layout을 정하면 된다.

comments

댓글 기능을 의미한다. tale을 만든 제작자는 Disqus 기능을 활용할 수 있도록 만들어 놨고 이곳에 true를 사용하면 그 기능을 이용할 수 있게 디자인을 만들어 놨다.

Disqus가 무료 기능이긴 하지만 사용자 본인이 직접 요청해서 url을 받아야 사용 가능하다. 따라서 comments에 true를 썼는데 댓글 기능이 안 나온다고 당황하지 말자

파일 올리기

마크다운 문서를 github io 형식에 맞게 만들었다면

이제 올리는 일만 남았다.

이 파일을 repository의 _posts 저장해야 한다.

대신 이름의 형식은 yyyy-mm-dd-이름으로 해야 한다.

그래야 포스팅 날짜를 blog에서 지정해줄 수 있다.

Discussion and feedback

← → Top