전체 글로 돌아가기
개발2026.06.05

블로그 글 쓰는 법 — 마크다운 규칙 전부 써보기

이 블로그가 지원하는 모든 마크다운 요소를 한 글에서 전부 써봅니다. 제목·목록·코드·인용·콜아웃·이미지·표·구분선까지.

이 글은 블로그가 지원하는 모든 마크다운 요소를 한 번에 보여주는 레퍼런스입니다. 새 글을 쓸 때 이 문서를 펼쳐두고 그대로 따라 쓰면 됩니다.

01제목과 문단

본문은 평범한 문단으로 시작합니다. h2는 자동으로 번호(01, 02...)가 붙고 목차에 들어갑니다. 더 작은 소제목은 h3를 씁니다.

소제목 예시

문단 안에서 굵게, 기울임, 그리고 인라인 코드를 섞어 쓸 수 있습니다. 외부 링크도 자유롭게 넣으세요.

02목록

순서 없는 목록:

  • 첫 번째 항목
  • 두 번째 항목
    • 중첩된 항목
  • 세 번째 항목

순서 있는 목록:

  1. 문제를 정의한다
  2. 가장 단순한 해법을 만든다
  3. 테스트로 검증한다

03코드

인라인은 const x = 1처럼, 블록은 아래처럼 씁니다.

async function publish(post: Post): Promise<void> {
  const html = await renderMarkdown(post.body);
  await commit(`content/posts/${post.slug}.md`, serialize(post));
}

04인용과 콜아웃

좋은 코드는 읽기 쉬운 코드다. 컴퓨터가 이해하는 코드는 누구나 짤 수 있다. — Martin Fowler

콜아웃은 인용문 첫 줄에 [!LABEL]을 붙여 만듭니다:

NOTE

생성된 코드는 항상 직접 읽고 테스트로 검증하세요. AI는 판단을 대체하지 않고 증폭합니다.

TIP

커버 이미지는 글을 쓸 때만 설정되고, 발행 시 저장소에 함께 커밋됩니다.

05이미지

플레이스홀더 다이어그램

06

요소 문법 비고
제목 ## 제목 자동 번호 + 목차
코드 ```lang 구문 강조 토큰
콜아웃 > [!NOTE] 디자인 콜아웃 블록

07구분선

아래는 구분선입니다.


여기까지가 이 블로그에서 쓸 수 있는 마크다운 요소 전부입니다. 즐겁게 쓰세요.

#markdown#writing#guide
HK
김현기
AI-Native Software Engineer

AI를 페어로, 판단은 사람이 — 더 빠르게 짓고 더 깊게 검증한 기록.

이어서 읽기

related
첫 블로그 글 게시!!
문화2026.06.06

첫 블로그 글 게시!!

안녕하세요? 야르르 ㅇㅇ ㅋㅋㅋ ㅋㅋㅋㅋ

Blog