마크다운이란?
마크다운은 #, *, - 같은 간단한 기호만으로 제목·강조·목록을 표현하는
글쓰기 문법입니다. Koding의 글쓰기 에디터(왼쪽 입력 → 오른쪽 미리보기)와
GitHub 동기화로 가져오는 .md 파일 모두 같은 문법을 씁니다.
제목 (Heading)
# 개수로 단계를 나눕니다. # 하나는 글 제목과 같으니 본문에서는
##부터 쓰는 것을 권장합니다.
# 가장 큰 제목 (H1)
## 소제목 (H2)
### 더 작은 제목 (H3)
강조 (Bold / Italic)
**굵게** 표시하거나 *기울임* 으로 강조합니다.
`~~취소선~~` 도 됩니다.
→ 굵게 표시하거나 기울임 으로 강조합니다. 취소선 도 됩니다.
목록 (List)
- 순서 없는 목록
- 항목 2
- 들여쓰기로 하위 항목
1. 순서 있는 목록
2. 두 번째
→ 결과:
- 순서 없는 목록
- 항목 2
- 들여쓰기로 하위 항목
- 순서 있는 목록
- 두 번째
인용 (Quote)
> 인용문은 이렇게 표시됩니다.
> 줄을 이어서 쓸 수 있습니다.
→
인용문은 이렇게 표시됩니다. 줄을 이어서 쓸 수 있습니다.
코드
문장 안에서는 백틱(`)으로 감싸 인라인 코드를 만듭니다.
여러 줄 코드는 백틱 3개 줄로 위아래를 감싸고, 첫 줄에 언어 이름을 적으면
문법 하이라이트가 됩니다. 아래처럼 쓰면:
```ts → 코드 → ``` 로 감싼다는 뜻입니다.
→ 결과:
const greet = (name: string) => `안녕, ${name}`;
링크와 이미지
[링크 텍스트](https://koding.kr)

이미지는 에디터에서 버튼·드래그·붙여넣기로 바로 올릴 수 있습니다.
GitHub 동기화의 경우, 저장소 안의 상대경로 이미지
( 또는 [이미지:images/a.png])도 자동으로
공개 저장소에 업로드되어 누구에게나 보입니다.
표 (Table)
| 이름 | 역할 |
| --- | --- |
| Claude | 코딩 도우미 |
| Koding | 지식 공유 |
→
| 이름 | 역할 |
|---|---|
| Claude | 코딩 도우미 |
| Koding | 지식 공유 |
구분선과 체크리스트
---
- [x] 끝난 일
- [ ] 할 일
→
- 끝난 일
- 할 일
임베드 (YouTube·X·CodePen 등)
링크를 한 줄에 단독으로 두면 자동으로 임베드됩니다. 에디터의 임베드 버튼을 쓰면 자동으로 이 형태로 넣어줍니다.
https://www.youtube.com/watch?v=xxxxxxxx
지원: X · YouTube · CodePen · GitHub Gist · JSFiddle · StackBlitz · Figma · Docswell (SlideShare·SpeakerDeck은 링크 카드)
해시태그로 태그 달기
본문 맨 마지막 줄에 #태그를 3개 이상 적으면 글의 태그로 자동 등록됩니다.
#ClaudeCode #MCP #바이브코딩
GitHub 동기화 — 파일·프론트매터 구조
GitHub 저장소를 연결하면 지정한 폴더(기본 posts/) 안의 .md 파일이 Koding 글로 자동 등록·갱신됩니다. 파일 맨 위의 프론트매터(--- 사이의 영역)로 제목·공개 여부·태그를 지정할 수 있습니다.
파일 예시 (posts/my-first-post.md)
---
title: Claude Code로 블로그 만들기
published: true
tags: [ClaudeCode, Next.js, Supabase]
---
여기부터 본문입니다. 마크다운 그대로 쓰면 됩니다.
## 소제목
- 내용 1
- 내용 2
#ClaudeCode #바이브코딩 #개발일지
프론트매터 항목
| 항목 | 필수 | 설명 |
|---|---|---|
title | 선택 | 글 제목. 없으면 본문 맨 위 # 제목(H1)을, 그것도 없으면 파일명을 제목으로 씁니다. 본문에 쓴 H1 제목은 중복 방지를 위해 자동 제거됩니다. |
published | 선택 | true면 공개, false면 비공개(임시 저장). 생략하면 기본 공개됩니다. |
tags | 선택 | 태그 목록. 배열([a, b]) 또는 쉼표 문자열(a, b) 모두 가능. 본문 마지막 줄의 #해시태그(3개 이상)와 합쳐집니다. 최대 20개. |
동기화 규칙
- 지정 폴더(기본
posts/) 및 그 하위 폴더의.md파일만 가져옵니다. - 파일이 바뀌면(내용 해시 변경) 글이 자동 갱신됩니다. URL(slug)은 유지됩니다.
- 본문의 상대경로 이미지(
,[이미지:images/a.png])는 자동으로 공개 저장소에 업로드됩니다. 큰 이미지는 자동 리사이징됩니다. - 푸시할 때 자동 동기화되도록 웹훅을 켤 수 있습니다(마이페이지 → GitHub 연동).
연결은 어디서 하나요?
헤더의 @내 계정 → 설정 · GitHub 연동 에서 저장소와 폴더를 지정하면 됩니다.