마크다운 체크박스

체크박스(작업 목록이라고도 함)는 마크다운 문서에서 할 일 목록을 만들고, 진행 상황을 추적하고, 작업을 정리하는 좋은 방법입니다. 대화형 체크박스를 지원하는 GitHub, GitLab 및 기타 플랫폼에서 특히 유용합니다.

기본 체크박스 문법

체크박스의 문법은 공백이나 'x'가 들어간 대괄호를 사용합니다: 

- [ ] 체크되지 않은 체크박스
- [x] 체크된 체크박스
- [ ] 또 다른 체크되지 않은 항목

결과:

  • 체크되지 않은 체크박스

  • 체크된 체크박스
  • 또 다른 체크되지 않은 항목

중요한 문법 규칙

1. 공백 요구사항

  • •
    하이픈 다음에 공백 필요: - [ ] (not -[ ])
  • •
    체크되지 않은 것은 대괄호 안에 공백: [ ] (not [])
  • •
    체크된 것은 소문자 'x': [x] (not [X])

2. 목록 형식

체크박스는 목록의 일부여야 합니다(-, +, 또는 * 사용): 
- [ ] 이것은 작동합니다
* [ ] 이것도 작동합니다
+ [ ] 이것도 작동합니다

[ ] 이것은 작동하지 않습니다 (목록에 없음)

중첩 체크박스

하위 작업이 있는 중첩 작업 목록을 만들 수 있습니다: 

- [ ] 메인 작업
  - [ ] 하위 작업 1
  - [x] 하위 작업 2 (완료)
  - [ ] 하위 작업 3
- [x] 또 다른 메인 작업
  - [x] 그것의 하위 작업

결과:

  • 메인 작업

  • 하위 작업 1
  • 하위 작업 2 (완료)
  • 하위 작업 3
  • 또 다른 메인 작업
  • 그것의 하위 작업

실용적인 예시

일일 할 일 목록

## 오늘의 작업

- [ ] 이메일 확인
- [ ] 프로젝트 제안서 검토
- [x] 오전 10시 팀 회의
- [ ] 문서 업데이트
- [ ] 내일 업무 계획

프로젝트 계획

## 웹사이트 재디자인 프로젝트

- [x] 리서치 단계
  - [x] 사용자 인터뷰
  - [x] 경쟁사 분석
  - [x] 요구사항 수집
- [ ] 디자인 단계
  - [x] 와이어프레임
  - [ ] 비주얼 디자인
  - [ ] 프로토타입

다른 서식과 혼합

체크박스를 다른 마크다운 서식과 결합할 수 있습니다: 

- [x] **중요한 작업** (완료)
- [ ] *일반 작업* (진행 중)
- [ ] `코드 리뷰` 프로젝트
- [ ] [문서 링크](https://example.com)
- [ ] ~~취소된 작업~~ (취소선)

결과:

  • 중요한 작업 (완료)

  • 일반 작업 (진행 중)

  • 코드 리뷰 프로젝트

  • 문서 링크
  • 취소된 작업 (취소선)

문제 해결

일반적인 문제

  1. 체크박스가 렌더링되지 않음: 공백과 목록 형식 확인

  2. 대화형이 아님: 플랫폼에서 대화형 체크박스를 지원하지 않을 수 있음
  3. 일관성 없는 모양: 플랫폼마다 체크박스 스타일이 다름

올바른 vs 잘못된 문법

❌ 잘못된 것: 

-[ ] 하이픈 후 공백 없음
- [] 대괄호에 공백 없음
- [X] 대문자 X
[ ] 목록에 없음

✅ 올바른 것: 

- [ ] 하이픈 후 공백
- [ ] 대괄호에 공백
- [x] 소문자 x

체크박스는 작업을 정리하고 진행 상황을 추적하는 데 완벽합니다. 문서를 대화형으로 만들고 프로젝트를 체계적으로 유지하는 데 도움이 됩니다!

시각적 콘텐츠를 추가할 준비가 되셨나요? 다음으로 마크다운의 이미지에 대해 배워보세요.