마크다운, 딱 이것만 배우자

문서에 다양한 정보 넣기

1. 링크 연결하기

웹페이지를 연결하려면 [보일 글자](주소) 형식을 사용합니다.

대괄호에는 독자가 볼 설명을, 소괄호에는 이동할 주소를 넣습니다. 주소 전체를 보여주는 대신 어디로 이동하는지 알 수 있게 작성해 보세요.

2. 이미지 삽입하기

이미지는 링크 앞에 느낌표 !를 붙입니다. 기본 문법은 ![대체 텍스트](이미지 주소 또는 파일 경로)입니다.

입력	표시 결과


위 파일이 실제로 images 폴더에 있을 경우 미리 보기에서 이미지가 나타납니다. 이미지가 보이지 않을 때는 파일 이름과 상대 경로부터 확인해 보세요. ![책 표지]의 설명은 이미지가 표시되지 않거나 화면 읽기 도구로 문서를 읽을 때 도움이 됩니다. 웹 이미지 주소도 사용할 수 있습니다.

주의: `example.com/photo.png`는 형식을 보여 주기 위한 예시 주소이며 실제 이미지가 있다는 뜻은 아닙니다.

3. 인용문 작성하기

다른 사람의 말이나 별도로 강조할 내용을 인용할 때는 줄 앞에 >를 씁니다.

인용문 안에서도 굵게 표시하거나 목록을 넣을 수 있습니다. 다만 다른 사람의 문장을 가져왔다면 필요에 따라 출처도 함께 남기세요.

4. 코드 블록 사용하기

짧은 코드나 명령어를 문장 안에 넣을 때는 백틱 하나, 여러 줄을 넣을 때는 백틱 세 개를 사용합니다. 코드 블록 시작 기호 바로 뒤에 python, bash, json 같은 언어 이름을 붙이면 지원하는 도구에서 문법이 색으로 구분됩니다.

입력 예제: 아래 바깥쪽 네 개의 백틱은 책에서 예제를 보여 주기 위한 장치입니다. 실제 파일에는 안쪽의 세 개짜리 백틱만 입력하면 됩니다.

print("안녕하세요, 마크다운!")

설명문 안에서 파일명을 표시할 때는 README.md처럼 백틱 하나씩 사용하면 됩니다. 코드 블록은 실행 기능이 아니라 코드를 모양 그대로 보여 주는 기능입니다.

5. 표로 정보 정리하기

여러 항목을 비교할 때는 세로줄 |과 구분 기호 ---를 사용합니다. 첫 줄은 열 제목, 두 번째 줄은 제목과 내용을 나누는 구분선, 그 아래는 데이터입니다.

마크다운 원본

| 도구 | 사용 목적 |
|---|---|
| ChatGPT | 초안 작성 |
| GitHub | 프로젝트 소개 |
| Obsidian | 개인 노트 |

미리 보기 결과

표는 편리하지만 휴대전화에서는 가로로 길어질 수 있습니다. 긴 설명보다는 짧은 비교 정보에 적합합니다. 표 문법도 널리 쓰이는 확장 문법이므로 편집기에 따라 지원 여부가 다를 수 있습니다.

2장 실습: 자주 방문하는 웹사이트 링크 하나, 이미지 하나, 비교 표 하나를 자신의 학습 노트에 추가해 보세요.