글쓰기에 마크다운(markdown)

: 마크다운 문법에 대한 정리는 다른 사이트, 블로, 카페 등에서 보다 잘 잘리된 것들이 있으니 그것을 참고하길 바람

마크다운이란

마크다운(markdown)은 일반 텍스트 기반의 경량 마크업 언어다. 일반 텍스트로 서식이 있는 문서를 작성하는 데 사용되며, 일반 마크업 언어에 비해 문법이 쉽고 간단한 것이 특징이다.

마크다운은 쉽게 말해 단순한 일반 텍스트를 특정 규칙에 맞게 작성하면 알아서 제목으로 만들어주기도 하고, 두껍게 보이게도 하며, 목록, 체크박스 등등으로 서식이 있는 텍스트로 바꿔주는 것입니다. 이렇게 만들어주는 규칙이 매우 쉽고 직관적입니다. 마크다운은 개발자 중심에서 대중적으로 많이 사용되고 있습니다. 마크다운은 다음과 같은 장점이 있기 때문입니다.
참고 : 위키 마크다운

마크다운 특징

각기 다른 편집기와 서식에서 어느정도 해방 가능하다.
서식이란 틀에 구속받지 않고 간단한 몇개의 룰만 익히면된다 (사실 마크다운 문법은 몇개 안된다)
어느정도 공통적으로 쓰이는 노트 프로그램에서 통일성을 유지 (옵시디언, 로지시크, 조플린 등)
텍스트 기반이기에 메모장 같은 텍스트 유틸로 열어서 확인 가능하다

유념할 사항

- 마크다운 방식을 이용하는 디지털 노트 도구에서 모두 호환되는 것은 아니다. 기본 개념을 마크다운 형태를 가져와서 대부분의 프로그램들은 좀 더 편하도록 또는 추가적인 기능을 위해 다르거나 추가적인 문법을 사용하기도 한다.

예) 옵시디언은 문서와 문서를 연결하기 위한 "링크"를 위키방식 [[문서의 연결]] 과 마크다운방식[문서의연결](./inbox/예제문서.md)

1. 위키방식 : 문서의 링크를 위해 [[이 안에 문서제목을작성한다]]

- 해당문서파일이 어느 장소에 있는지 뒤에 괄호로 기술하는 마크다운표준방식에 비해 간략한 장점이 있으나 표준마크다운방식을 쓰는 다른 노트에서는 호환이 안되는 경우가 있다.

- [[안에 들어갈 이름이]] 단 하나만 존재하기 때문에 어느 장소에서 지정해도 해당 이름을 가진 문서로 가는 장점이 있어 간략하고 신속한 글 작성에 도움이 된다.

- 대표적 옵시디언이 이 방식을 지원하고 있다.

2. 마크다운방식 : 문서의 링크를 위해 [링크이름](링크될 문서가 위치한 장소/웹사이트/이미지 등)

문서의 링크

[문서의 연결](./inbox/예제문서.md)

파일등의 링크

[세금계산서 엑셀파일](./inbox/문서파일/2025세금계산서.xls)

이미지의 링크

[토끼그림]( ./inbox/_resources/토끼그림.jpg)

3. 마크다운의 기본적인 문법

: 대략적인 사항을 예로 들어 설명하면 아래와 같다.

: 마크다운의 가장 큰 장점은, 키보드에서 마우스로 손을 이동하지 않고 빠르게 글을 작성해 나갈 수 있다는 점이다. 몇개 되지 않은 비교적 간단한 문법이기에 익히기도 쉽다 (물론 각종 워드프로세스 프로그램도 마우스 없이 단축키고 가능하지만)

제목
- 문단을 구별해주기 위한 기능으로 차후 개요를 구성할때도 자동으로 개요를 구성할 수 있다
- 좌측 마크다운 방식으로 그냥 작성하면 젤 우측 렌더링 된 결과물로 출력된다

구분선 " --- "
- 문단 사이에 넣어서 위 아래의 구별 등이 필요할때
- 단 " --- " 위, 아래는 공백이어야 한다. 내용이 있으면 아래처럼 굵은 제목과 같은 기능이 된다.

목록 (넘버링 형태와 비넘버링 형태) : 깊이는 키보드의 TAP으로 들여쓰기 쉬프트+탭으로 내어쓰기

체크박스: 할일처럼 체크리스트가 필요한 항복은 " - [ ] " 기입하면 자동으로 체크박스가 완성된다.

하이라이트(형광펜) : ==글==
강조(굵게) : *글*
취소선 : ~~글자~~
기울임(이텔릭체) : *글*

인용구 : > 이후 글작성

코드블럭 : ``` 과 ``` 으로 위아래
- (글 내부에 코드내용을 작성할때 문법에 영향을 받지 않고 표현)

```
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

인라인 코드 : ' 와 ' 안에 코드내용 기재
- (글 내부에 코드내용을 문단이 아닌 작성할때 문법에 영향을 받지 않고 표현)

예) 보통은 이렇듯 `"age": 25` 해당 부분이 문제가 되는 경우가 많다.

탈출 : 제일 앞에 \ 를 기재
- (문법에 영향받지 않고 표시 하는 주석 비슷한 역활)
- 예로 마크다운 문법중 # 는 헤드라인 제목을 표현하지만 \# 이런식으로 작성되었다면 무효화 될 수 있다.

수식 : 수식을 표현해준다. 본인은 안써서 잘 모름

링크 : 연결을 구성하는 문법
- 마크다운방식 :기본 적인 마크다운 방식은 [ ] 로 이름을 지정하고 뒷부분 ( ) 안에 파일의 위치를 (상대위치/절대위치) 를 기재하여 링크를 건다.
  - 문서의 링크를 위해
  - [링크이름](링크될 문서가 위치한 장소/웹사이트/이미지 등)
    - [문서의 연결](./inbox/예제문서.md)
    - 파일, 이미지 등의 링크
      [토끼그림]( ./inbox/_resources/토끼그림.jpg)
    - [세금계산서 엑셀파일](./inbox/문서파일/2025세금계산서.xls)

외부 링크
- 웹사이트 :
  - 원칙적으로는 위 링크와 같은 동일한 방식으로 하지만
  - [구글이라는 사이트](https://www.google.com/)
  - 로 작성해야 하지만 대부분은 노트도구 프로그램에서는 그냥 https://www.google.com/ 웹주소만 기재해도 링크 된다.
주석 (각주)
- [^1] 로 숫자로 각주를 달거나
- [^구글] 로 각주를 달거나
- ^[구글은 신입니다.] 라는 형태로 각주자체를 그 줄에서 기술 할 수 있다.

표(Table)
- 사실상 마크다운에서 가장 불편한 문법은 표라고 생각된다.
- 본인은 HWP한글문서 프로그램을 수년간 주력으로 사용해서 표를 필요이상으로 활용했었다.
- 이를 해결하기 위해 여러 플러그인이 있지만 그냥 표를 최소한으로 사용하고 있다.
- 표를 도무지 포기할 수 없다면 플러그인으로 좀더 작성에 편의점을 줄 수 있지만 시원하게 이참에 포기하는 걸 추천한다. (본인도 이전까지는 표가 없는 문서가 존재할 수 있을까라는 생각을 했었다)

4. 옵시디안 마크다운 레퍼런스 가이드 #마크다운

: 보다 자세한 마크다운의 내용은 옵시디언에서 제공하는 레퍼런스 가이드를 참고

[https://www.markdownguide.org/tools/obsidian/](https://www.markdownguide.org/tools/obsidian/)
[https://help.obsidian.md/Editing+and+formatting/Basic+formatting+syntax](https://help.obsidian.md/Editing+and+formatting/Basic+formatting+syntax)