CH06 마크다운(MarkDown), 머메이드(Mermaid) 학습

2026.09.23(수)

오늘의 학습 내용

• 마크다운(MarkDown)
• 머메이드(Mermaid)

마크다운(MarkDown)이란?

개념

마크다운(MarkDown)은 일반 텍스트에 몇 가지 기호를 섞어 문서의 구조를 표현하는 표기 방식으로 2004년 존 그루버(Jonh Gruber)가 제작함

문서에 서식을 넣는 방법은 이전에도 존재하였음
대표적으로 HTML(HyperText Markup Language, 웹 문서를 기술하는 표기 언어)은 <h1>제목</h1>처럼 태그로 감싸고, 워드프로세서는 파일 안에 서식 정보를 따로 저장함

그러나 두 방식 모두 서식을 적용한 뒤에는 원본이 사람이 읽기 어려운 형태가 됨

"The overriding design goal for Markdown's formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it's been marked up with tags or formatting instructions." (마크다운 서식 문법의 가장 우선하는 설계 목표는 가능한 한 읽기 쉽게 만드는 것이다. 마크다운으로 작성한 문서는 태그나 서식 지시자로 표시된 것처럼 보이지 않은 채, 일반 텍스트 그대로 출판 가능해야 한다는 것이 그 취지다.)

• John Gruber

마크다운의 설계 목표

즉 기호를 붙인 상태에서도 그냥 읽히는 것이 목표
**중요**라고 쓴 문장은 서식이 적용되지 않은 상태에서도 무엇을 강조하려 했는지 그대로 보임

이 방식은 개발 현장에서 널리 쓰이게 되며 코드와 함께 텍스트 파일로 보관할 수 있고, 변경 이력을 줄 단위로 비교할 수 있기 때문입니다. GitHub의 저장소 설명 문서(README), 이슈와 코드 리뷰 본문, 기술 문서가 대부분 마크다운으로 작성됨

실제 마크 다운과 github의 프로젝트를 활용하여 개인학습 github 페이지를 꾸며봄

• 쉽고 간단하게 많은걸 구현할수있다!

기울어짐 굵게 굵게 기울어짐

표준과 확장

마크다운에는 하나의 표준만 있는 것이 아님

• 원본 명세 - 2004년에 발표된 최초 규격입니다. 규칙에 모호한 부분이 있어 프로그램마다 해석이 갈림
• CommonMark - 그 모호함을 없애기 위해 만들어진 표준 규격입니다. 오늘날 대부분의 마크다운 처리기가 이것을 기준으로 함
• GFM (GitHub Flavored Markdown) - GitHub이 CommonMark 위에 표·작업 목록 같은 기능을 얹은 것
• Obsidian - Obsidian이 자체적으로 얹은 문법이 따로 존재

문법과 형식

줄 맨 앞에 #을 놓고 공백을 하나 넣은 뒤 제목을 작성, #의 개수가 단계를 뜻하며 1개부터 6개까지 쓸 수 있음

# 1단계 제목
## 2단계 제목
### 3단계 제목
#### 4단계 제목
##### 5단계 제목
###### 6단계 제목

언어 지정

여는 펜스 뒤에 언어 이름을 적으면 그 언어의 문법에 맞게 색이 입혀짐

using UnityEngine;

public class Player : MonoBehaviour
{
    [SerializeField] private float _moveSpeed = 5f;

    private void Update()
    {
        float horizontal = Input.GetAxis("Horizontal");
        transform.Translate(Vector3.right * horizontal * _moveSpeed * Time.deltaTime);
    }
}

머메이드(Mermaid)란?

아래와 같은 간단한 문법만으로 간단하게 차트를 만들수 있음

flowchart LR
A["출발"] --> B["조건1"]

B --[참]--> C["성공"]

B --[거짓]--> D["실패"]