구문 연습

구문 참조

Markdown 구문이란?

Markdown은 2004년 John Gruber가 만든 경량 플레인 텍스트 서식 언어입니다. 간단한 기호와 문자를 사용하여 텍스트를 마크업하므로 원시 형태에서도 지저분해 보이지 않으면서 HTML로 변환되는 콘텐츠를 쉽게 작성할 수 있습니다. Markdown은 문서, README 파일, 블로그 및 간단하고 읽기 쉬운 서식이 필요한 콘텐츠의 표준이 되었습니다. HTML처럼 열기 태그와 닫기 태그가 필요하지 않고 강조에는 별표, 목록에는 하이픈과 같은 직관적인 마커를 사용하므로 플레인 텍스트를 입력할 수 있는 누구나 사용할 수 있습니다.

CommonMark는 파서가 구문을 해석하는 방법을 정의하는 가장 널리 인정받는 Markdown 사양입니다. 원래 구문이 많은 엣지 케이스를 정의하지 않아 다양한 플랫폼에서 Markdown 동작을 표준화하려는 커뮤니티 노력에서 탄생했습니다. CommonMark 호환 구문을 배우면 GitHub, GitLab, Discord, Slack, Reddit, Stack Overflow 및 수십 개의 다른 플랫폼에서 콘텐츠가 일관되게 렌더링됩니다. John Gruber의 원래 Markdown 사양은 여전히 기초가 되며, GitHub Flavored Markdown과 같은 확장 기능이 작업 목록, 취소선 텍스트, 표와 같은 기능을 추가합니다.

현대 Markdown은 특정 플랫폼에 맞춘 여러 방언이 있습니다. GitHub Flavored Markdown (GFM)은 표, 체크박스, 자동 링크를 추가합니다. GitLab Markdown은 유사한 확장 기능에 더해 다이어그램을 지원합니다. CommonMark 핵심 구문을 배우면 어디서나 작동하는 이식 가능한 기반을 얻을 수 있으며, 필요할 때 플랫폼별 확장 기능을 활용할 수 있습니다.

Markdown 구문 가이드 사용 방법

다음 단계에 따라 Markdown 구문을 학습하고 연습하세요. 각 단계는 이 페이지의 실제 패널을 사용합니다.

붙여넣기, 업로드, 또는 샘플 불러오기

왼쪽 구문 연습 패널에 Markdown을 붙여넣거나, 업로드를 클릭하여 .md 파일을 불러오세요. 샘플을 클릭하면 구독자 API 문서 예시를 확인할 수 있습니다. 오른쪽 구문 참조 패널에 CommonMark와 GFM 패턴이 표시됩니다.

연습 및 참조

제목, 강조, 목록, 링크, 표, 코드 블록에 대한 참조를 활용하세요. 왼쪽 패널에 예시를 복사하여 직접 시도해보세요. CommonMark와 GitHub Flavored Markdown 확장을 모두 다룹니다.

복사 또는 다운로드

복사 또는 다운로드를 클릭하여 참조를 저장하세요. 초기화로 처음부터 다시 시작할 수 있습니다. 모든 처리는 브라우저에서 실행됩니다.

실제 활용 사례

문서 작성

기술 문서, API 참조 가이드, 소프트웨어 문서는 거의 보편적으로 Markdown으로 작성됩니다. Python 문서, Node.js 가이드, 대부분의 오픈 소스 프로젝트가 문서 사이트에 Markdown을 사용합니다. 구문 참조가 있으면 여러 제목 수준, 코드 예시, 상호 참조가 포함된 복잡한 문서를 작성할 때 생산성을 유지할 수 있습니다.

README 및 프로젝트 파일

모든 GitHub 프로젝트에는 프로젝트, 사용법, 설치, 기여 가이드라인을 설명하는 README.md 파일이 있습니다. 이 파일들은 완전히 Markdown으로 작성되어 있으며 사용자가 처음 보는 것입니다. 기능 비교를 위한 표, 예시를 위한 코드 블록, 서식화된 목록은 README 파일의 표준 요소입니다.

콘텐츠 제작 및 게시

Jekyll, Hugo, Ghost와 같은 블로그 플랫폼은 콘텐츠에 Markdown을 사용합니다. Medium 스타일 플랫폼, Ghost 플랫폼, 정적 사이트 생성기는 모두 Markdown을 주요 입력 형식으로 사용합니다. 구문을 알면 더 빠르게 작성하고 게시하는 모든 콘텐츠에서 일관된 서식을 유지할 수 있습니다.

협업 커뮤니케이션

Slack, Discord, GitHub 이슈, PR 댓글, 포럼 게시물은 모두 Markdown 서식을 지원합니다. 코드 리뷰, 버그 보고, 채팅에서의 협업 시 Markdown을 사용하면 대화 흐름을 방해하지 않고 메시지를 명확하게 서식화할 수 있습니다. 구문 기본 지식은 일상적인 워크플로에서 시간을 절약해줍니다.

자주 묻는 질문(FAQ)

Markdown 안에서 HTML을 사용할 수 있나요?

네, Markdown에서 원시 HTML을 혼합할 수 있습니다. Markdown이 지원하지 않는 기능이 필요한 경우 HTML을 직접 작성하면 출력에 그대로 전달됩니다. 그러나 소스의 이식성과 가독성이 떨어집니다. CommonMark 사양에 따르면 HTML 블록과 인라인 HTML은 인식되어 변경 없이 전달됩니다. 최소한으로 사용하세요. 보통은 Markdown 구문으로 충분합니다.

강조를 위한 별표와 밑줄의 차이는 무엇인가요?

CommonMark에서 기능적으로는 동일합니다. *텍스트*와 _텍스트_는 모두 이탤릭체를, **텍스트**와 __텍스트__는 모두 굵게 표시됩니다. 선택은 스타일의 문제입니다. 많은 팀이 일관성을 위해 별표를 선호하며 대부분의 키보드에서 입력하기 쉽기 때문입니다. 밑줄은 강조와 유사한 패턴을 가진 단어(예: "file_name_here")에서 문제를 일으킬 수 있으므로 별표가 권장되는 경우가 많습니다.

Markdown에서 줄 바꿈은 어떻게 작동하나요?

이것은 흔한 혼란의 원인입니다. 소스의 단일 줄 바꿈은 공백으로 처리되어 다음 줄과 합쳐집니다. 실제 줄 바꿈(HTML의 <br>)을 만들려면 Enter를 누르기 전에 줄 끝에 공백 두 개를 추가하거나 줄 바꿈 전에 백슬래시를 사용하세요. 단락 나누기에는 빈 줄(두 개의 연속 줄 바꿈)을 사용하세요. CommonMark 사양에서 이를 자세히 설명합니다.

Markdown 표는 모든 곳에서 지원되나요?

아니요. 표는 GitHub Flavored Markdown과 기타 확장의 일부이지만 CommonMark 사양에는 포함되지 않습니다. 대부분의 현대 플랫폼(GitHub, GitLab, Discord)에서는 지원하지만 일부 파서는 파이프 구문을 무시합니다. 어디서나 표가 작동해야 한다면 대상 플랫폼이 GFM을 지원하는지 확인하거나 다른 방식을 고려하세요.

특수 문자를 어떻게 이스케이프하나요?

Markdown에서 특별한 의미를 가진 문자 앞에 백슬래시(\)를 붙이세요. 대상 문자: 백슬래시 자체(\), 백틱(`), 별표(*), 밑줄(_), 중괄호({}), 대괄호([]), 소괄호(()), 해시(#), 더하기(+), 빼기(-), 마침표(.), 느낌표(!). 예를 들어 \*이탤릭 아님\*은 이탤릭체를 만들지 않고 별표를 그대로 표시합니다. CommonMark 백슬래시 이스케이프에 따르면 이 특정 문자들만 이스케이프가 필요합니다.

Markdown에서 코드를 서식화하는 가장 좋은 방법은?

인라인 코드에는 단일 백틱을 사용하세요: `코드 여기`. 코드 블록에는 구문 강조를 위해 선택적 언어 태그(```javascript)와 함께 트리플 백틱을 사용하세요. 코드 블록으로 들여쓰기는 피하세요. 펜스 코드 블록이 더 명확하고 이식성이 높습니다. 백틱이 포함된 코드를 표시해야 한다면 더 많은 백틱으로 구분하세요: ` ``백틱`` `. CommonMark 사양의 코드 스팬과 펜스 코드 블록을 참조하세요.

Markdown 구문 가이드