본문 바로가기
블로그

개인 블로그 만들기를 위한 여정4 - 마크다운으로 글쓰기

by devscb 2023. 11. 7.
반응형

hexo 에서 글을 써보자

hexo에서 글을 쓰기 위해서는 hexo 블로그가 위치한 폴더에서 아래 명령어를 수행합니다.

hexo new post [title]

그러면 블로그경로/source/_posts/에 [title].md 라는 파일이 만들어지는데요, 이 파일에 내용을 아래와 같이 작성하면 됩니다.

---
title: title
categories: ["category"]
tags: ["tag"]
date: 2023-10-19 01:12:25
---

*Hello Hexo!*
**Hello Hexo!**

아래 명령어로 서버를 실행한뒤, 브라우저로 접속하면 다음과 같은 화면이 나옵니다.

hexo server 

그런데, 문장의 앞뒤에 *을 입력했지만 표시되지 않았습니다.
표시되지 않고 해당 글자가 굵게 되거나 기울게 되었는데요,
이것이 마크다운의 역할입니다.

마크다운이란?

마크다운이란 한마디로, "스타일 있는 문서를 쉽게 만들수 있는 문법를 가진 언어"입니다.

마크다운은 아래 그림과 같이 markdown으로 문서를 작성하면,
변환해주는 markdown app의 html로 만들어 줍니다.
그 후, 우리가 브라우저에서 마크다운이 변환된 html 파일을 확인할 수 있습니다.

마크다운 파일의 확장자는 보통 .md 를 사용하며,
마크다운은 문서를 쉽고 빠르고 간결하게 쓸 수 있게 해줍니다.

문법

어떤 스타일을 지원하는지 알아보겠습니다.

제목 : 6단계 까지 가능합니다.

# 1단계 제목
## 2단계 제목

목록

* 목록 하나
* 목록 두울
* 목록 세엣
- 이렇게 써도
- 된답니다.

순서가 있는 목록

숫자는 반드시 맞춰 쓸 필요는 없습니다.
어차피 마크다운 기본문법에서는 각 행이 HTML의

  • 태그로 변환되는 것이라,
    번호가 사라지기 때문입니다.

 

1. 첫째입니다.
2. 둘째입니다.
3. 셋째입니다.
5. 넷째입니다. 다섯째 아닙니다.
6. 이게 다섯째입니다.
4. 이건 여섯째.

글자모양

**굵게**
*기울게* 

인용문

>> 인용문 depth2
> 인용문 depth1

링크

[링크명](https://devscb.com)

그림 넣기

![대체문구](https://devscb.com/images/test.jpg)

마크다운에서 지원하지 않는 경우

로그인 입력창같이 input 태그같은것을 쓸 경우가 있는데요,
이럴 경우에는 아래와 같이 그냥 태그를 쓰면됩니다.

<input type="text" />

총평

hexo를 사용하기 위해 마크다운을 소개하였는데요,
사실 대부분의 static generate blog들은 마크다운을 사용하는거 같습니다.
또한, 전자책이나 온라인 설명서, 위키 등도 마크다운으로 많이들 사용하므로 알아두시는게 여러모로 유용할 것입니다.
개인적으로도 익숙해지니 다른 방식으로 글쓰는 방식은 오히려 불편한거 같다는 생각도 듭니다.
특히, 위키를 사용할때 마크다운이 익숙한데,
제가 다니는 회사에서는 conflunence를 쓰고, 기본적으로 마크다운을 지원하지 않아서 문서 작성이 꽤 시간이 걸리더군요.
마크다운을 많은 일반인들도 사용할 수 있게 하여 보다 더 많은 프로그램에서 유용하게 쓸 수 있으면 좋겠습니다.

 

#blog,#블로그, #hexo, #헥소, #markdown, #마크다운

 

https://devscb.com/post/194

 

728x90
반응형

댓글