소프트웨어Markdown

7편. Markdown - Comment, Emoji

, , , , , ,

목차

  1. 코멘트 만들기
  2. 이모지 사용하기


코멘트 만들기

Markdown에도 코멘트를 써야 하는 경우는데 아래와 같은 방식으로 코멘트를 쓸 수 있다.

1
2
3
4
5
6
여기서부터 코멘트 ↓

[comment]: <> (원래 Markdown 문법에서는 이런 식으로 코멘트를 사용할 수 있다.)
[comment]: <> (이렇게 하면 소스코드 단에서만 보이고 본문에서는 보이지 않는다.)

여기까지 코멘트 ↑

여기서부터 코멘트 ↓

여기까지 코멘트 ↑


Markdown 코멘트는 간소화하여 아래와 같이 사용할 수 있다.

1
2
3
4
5
여기서부터 코멘트 ↓

[//]: <> (다만 어쨌든 이렇게 해도 꽤 복잡한 문법을 외워야 한다.)

여기까지 코멘트 ↑

여기서부터 코멘트 ↓

여기까지 코멘트 ↑


하지만 사실 Markdown은 Markup을 기반으로 하므로, 아래와 방식으로 사용하는게 제일 간편하긴 하다. 필자는 HTML에서 쓰던 방식이 익숙해서인지 모르겠지만, 개인적으로 아래 방식을 가장 선호한다.

1
2
3
4
5
6
7
여기서부터 코멘트 ↓

<!---
코멘트를 작성합니다.
-->

여기까지 코멘트 ↑

여기서부터 코멘트 ↓

여기까지 코멘트 ↑



이모지 사용하기

Markdown은 화려함을 많이 배제한 「경량화된 문법」을 장점으로 가지고 있다보니 문서로 만들고나면 글이 좀 심심할 수 있다. 그러니 정보만 전달하면 되는 개발 문서라면 모르겠으나, Markdown으로 사내 업무 위키를 사용하는 경우 한국말로 이모티콘(Emotion + Icon)이라고 부르는 그림 아이콘들을 추가하면 문서를 좀 더 화려하고, 재미있게 만들 수 있다.

GFM에서는 여러가지 이모지(Emoji)를 사용할 수 있다. 총 정리된 목록은 아래 링크에서 목록을 볼 수 있다.

위 링크에서 설명하는 이모지들은 현재 필자가 사용하고 있는 HEXO에서는 작동하지 않는다. 이 경우는 아래의 링크를 이용하여 Hexo에 추가적으로 Emoji를 추가하여 사용할 수 있다. 이 추가 기능은 Github Emoji API를 사용하여 Hexo에서 Emoji를 사용할 수 있도록 해 준다.

MacOS와 Windows10에서는 OS 자체에서 제공하는 이모지가 있으며, 이들은 UTF-8이므로 Markdown에 입력하면 웹브라우저에서 그대로 정상작동한다. 바로 이렇게 → 😎 (GFM이나 Github Pages의 SSG Framework와 상관 없다.) 현재 이 글은 2021년 2월 기준이므로, 이후 링크가 작동하지 않는 경우 OS가 버전 업그레이드되며 내용이 변경되었을 가능성이 있으므로 신규 검색을 부탁드린다.



주요 참고 자료