2019년 9월 11일, 회사 Atlassian 기술블로그에 올린 내용입니다.
마크다운 이란?
Markdown은 텍스트 기반의 마크업언어로 2004년 존그루버에 의해 만들어졌으며 쉽게 쓰고 읽을 수 있으며 HTML로 변환이 가능한 문법을 의미합니다.
특수기호와 문자를 이용한 매우 간단한 구조의 문법을 사용하여 웹에서도 보다 빠르게 컨텐츠를 작성하고 보다 직관적으로 인식할 수 있습니다.
마크다운이 최근 각광받기 시작한 이유는 깃헙덕분으로 알고 있습니다.
깃헙의 저장소Repository에 관한 정보를 기록하는 README.md는 깃헙을 사용하는 사람이라면 누구나 가장 먼저 접하게 되는 마크다운 문서입니다.
마크다운을 통해서 설치방법, 소스코드 설명, 이슈 등을 간단하게 기록하고 가독성을 높일 수 있다는 강점이 부각되면서 점점 여러 곳으로 퍼져가게 된되며, 현재 우리가 사용하고 있는 Atlassian 또한, 마크다운 문법을 간략하게는 지원하여, 해당 건에 대해 공유드립니다.
다만, 마크다운 문법의 경우 표준이 없으므로, github 의 마크다운 문법을 별도로 공부하시는 것이 좋으며, github, wiki, Atlassian 에서 비슷하지만 조금씩 다른 결과물, 혹은 지원하지 않는 것들이 있을 수 있습니다.
줄긋기
---
’-‘를 세번 연속으로 치면 문단선이 생깁니다.
마크다운 문법에서는 헤더나, 부제목을 만들기 위해 사용하는데, Atlassian 은 문단을 자르기 위한 용도로 사용됩니다.
(* 와 - 는 같은 값으로 인식합니다. *를 세번입력해도 상관없습니다.)
점표시
-
’-‘를 넣고 한칸띄우기(스페이스)를 누르면, 분단표시가 됩니다. 점표시로 변경하게 되며, 엔터를 키면 계속 목차가 이어지게 됩니다.
여기서 탭을 넣게 되면 dept 형태로 보여지게 됩니다.
’-‘ 하고 스페이스바를 눌렀을 경우
엔터를 치고 탭을 눌렀을 경우
(* 와 - 는 같은 값으로 인식합니다. *를 세번입력해도 상관없습니다.)
글자 크기 키우기
# This is a H1
## This is a h2
This is a H1
This is a H2
This is a H3
This is a H4
This is a H5
This is a H6
’#’을 누르고 한칸 띄우기를 하면 갯수에 따라 H1~H6 까지 자동으로 적용됩니다.
인용 문구 넣기
> 인용문구 넣기
인용문구 넣기
’>’ 를 넣고 한칸 뛰우기를 하면 됩니다. 마크다운 문법에서는 > 를 계속 넣으면서 여러 문용을 입력할 수 있는데, 여기는 단 한번만 넣을 수 있습니다.
링크 문서 삽입하기
Link: [Google](https://google.com) "Go google"
Link: Google “Go google”
[링크를 표시할 명칭] (링크 주소) 를 입력하고 한칸 띄울 경우, 위와 같이 링크 주소는 사라지고 링크명만 보여기데 됩니다.
( < a href=’’ 와 동일한 기능으로 생각해주시면될거같습니다. )
이미지 삽입하기
위의 링크와 동일하나 앞에 느낌표 ! 를 붙이면 이미지 삽입이 가능합니다. ( <img src=’’ 와 동일한 기능입니다. )
이모티콘
: 를 누르면 이모티콘이 나옵니다.
www.emoji-cheat-sheet.com 에 사용할 수 있는 여러가지 이모티콘이 올라와있으나,
동작을 안하고, ‘:’ 를 입력하면 Atlassian 용 이모티콘이 나오는 것으로 보여집니다.
이외에도 테이블을 표시하거나, 기타 여러가지 마크다운 문법이 있으니 관심있는 분은 조금더 확인하시는것도 나쁘지 않으나 이정도만 하더라도 Atlassian을 조금 이쁘게 꾸미실 수 있을 거라고 생각이 됩니다.
Atlassian 쓰시는 분들은 참고하시기 바랍니다.