기술 블로그를 Markdown으로 작성하는 꿀팁

Velog, GitHub Pages, Tistory 등 현대 대부분의 기술 블로그는 마크다운(Markdown) 생태계를 채택하고 있습니다. 훌륭한 기술 블로그 글을 만드는 작성 노하우를 알아봅니다.

1. 개요 및 목차(TOC) 구성

글을 시작하기 전 도입부와 목차를 제공하면 독자가 원하는 정보를 빠르게 찾을 수 있습니다.

# [React] useState 훅 완전 파헤치기

> useState의 동작 원리와 리렌더링 최적화 기법을 완벽히 정리합니다.

## 목차
1. useState란?
2. 상태 변경 시 일어나는 과정
3. 결론 및 요약

2. 코드 블록 작성 시 실수를 줄이는 법

코드 설명 시 단순히 코드만 올리지 않고, 주요 줄에 주석을 달거나 파일명을 명시해 주면 독자의 이해도가 비약적으로 올라갑니다.

// src/components/Counter.jsx
```jsx
import { useState } from 'react';

export function Counter() {
  const [count, setCount] = useState(0); // 1. 초기 상태 설정
  return <button onClick={() => setCount(count + 1)}>{count}</button>;
}
```

3. 핵심 강조 팁

• 강조하고 싶은 요약 문장은 인용구(>)로 묶어 독자의 시선을 사로잡으세요.
• 중요한 용어나 함수명은 백틱(```) 형태의 인라인 코드로 표시하세요.

직접 실습해보세요! 편집기에서 직접 실습하기 →