마크다운 문법 정리

가장 먼저 익힐 문법 6가지

• 제목: #, ##, ###로 문서 구조를 나눕니다.
• 목록: - 또는 1.으로 할 일과 순서를 정리합니다.
• 체크박스: - [ ], - [x]로 액션 아이템을 관리합니다.
• 링크: [텍스트](URL) 형식으로 참조를 남깁니다.
• 코드: 인라인 코드는 백틱 하나, 여러 줄 코드는 백틱 세 개를 씁니다.
• 인용문: >로 메모, 결론, 강조 문장을 분리합니다.

개발자가 특히 많이 쓰는 문법

개발 문서에서는 예쁜 포맷보다 구조와 검색성이 더 중요합니다. 실제로 자주 쓰는 건 체크리스트, 코드 블록, 링크, 표 정도입니다. 나머지는 필요할 때만 붙이면 됩니다.

# Sprint 14 회의록

## 결정 사항

1. 로그인 리팩터링은 이번 주 안에 마무리
2. 알림 기능은 다음 스프린트로 이월

## 액션 아이템

- [ ] 김지원: PR 정리
- [ ] 박소연: QA 시나리오 업데이트

## 참고 코드

```ts
startTransition(() => syncNotes());
```

표 만들기

세로선 |으로 열을 나누고, 헤더 아래에 | --- | --- | 구분선을 넣으면 표가 됩니다. 구분선에 콜론을 붙이면 정렬을 지정할 수 있습니다 — :---는 왼쪽, :---:는 가운데, ---:는 오른쪽 정렬입니다.

| 문법 | 기호 | 예시 |
| --- | :---: | --- |
| 제목 | # | # 제목 |
| 강조 | ** | **굵게** |
| 링크 | [ ]( ) | [Maku](https://trymaku.com) |

이미지 넣기

링크 문법 앞에 느낌표 !를 붙이면 이미지가 됩니다. 대괄호 안은 이미지가 안 보일 때 표시되는 대체 텍스트(alt)입니다.

![대체 텍스트](image.png)
![스크린샷](https://example.com/shot.png)

로컬 노트에서는 같은 폴더의 이미지 파일 경로를 그대로 쓰면 되고, Maku는 그 이미지를 노트와 함께 내 폴더에 보관합니다.

중첩 목록과 번호 목록

목록 아래에서 두 칸(또는 탭) 들여쓰면 하위 목록이 됩니다. 순서 없는 목록(-)과 번호 목록(1.)을 섞어서 쓸 수도 있습니다.

- 상위 항목
  - 하위 항목
    - 더 깊은 항목
1. 첫 단계
2. 둘째 단계
   - 세부 사항

각주와 주석

각주는 본문에 [^1]을 넣고 문서 아래에 [^1]: 설명으로 내용을 답니다. 화면에는 보이지 않는 주석(코멘트)이 필요하면 HTML 주석 문법 <!-- 메모 -->를 쓰면 렌더링에서 숨겨집니다.

본문 문장입니다.[^1]

[^1]: 각주로 다는 부연 설명입니다.

<!-- 이 줄은 화면에 보이지 않는 메모입니다 -->

Maku에서 특히 중요한 문법

Maku는 일반 Markdown 위에 위키링크와 백링크 흐름을 얹는 쪽에 강점이 있습니다. 그래서 문법 자체보다도, 문서를 서로 연결하는 습관이 더 중요합니다.

• 표준 Markdown 링크는 외부 문서나 웹 문서를 연결할 때 좋습니다.
• 위키링크는 내부 노트를 빠르게 연결할 때 좋습니다.
• 체크박스는 회의록과 일간 저널에서 액션 아이템을 찾기 쉽게 만듭니다.

문법을 익힌 다음 해야 할 일

문법을 다 외우는 것보다 더 중요한 건 실제 문서 템플릿에 바로 써보는 것입니다. 회의록, 일간 저널, 스펙 문서 같이 반복적으로 쓰는 형식을 하나 정해놓으면 Markdown은 금방 손에 익습니다.