Koding

마크다운 가이드

Koding에서 글을 쓸 때 쓰는 문법과, GitHub 동기화로 글을 가져올 때의 파일 구조를 정리했습니다.

마크다운이란?

마크다운은 #, *, - 같은 간단한 기호만으로 제목·강조·목록을 표현하는 글쓰기 문법입니다. Koding의 글쓰기 에디터(왼쪽 입력 → 오른쪽 미리보기)와 GitHub 동기화로 가져오는 .md 파일 모두 같은 문법을 씁니다.

제목 (Heading)

# 개수로 단계를 나눕니다. # 하나는 글 제목과 같으니 본문에서는 ##부터 쓰는 것을 권장합니다.

# 가장 큰 제목 (H1)
## 소제목 (H2)
### 더 작은 제목 (H3)

강조 (Bold / Italic)

**굵게** 표시하거나 *기울임* 으로 강조합니다.
`~~취소선~~` 도 됩니다.

굵게 표시하거나 기울임 으로 강조합니다. 취소선 도 됩니다.

목록 (List)

- 순서 없는 목록
- 항목 2
  - 들여쓰기로 하위 항목

1. 순서 있는 목록
2. 두 번째

→ 결과:

  1. 순서 있는 목록
  2. 두 번째

인용 (Quote)

> 인용문은 이렇게 표시됩니다.
> 줄을 이어서 쓸 수 있습니다.

인용문은 이렇게 표시됩니다. 줄을 이어서 쓸 수 있습니다.

코드

문장 안에서는 백틱(`)으로 감싸 인라인 코드를 만듭니다. 여러 줄 코드는 백틱 3개 줄로 위아래를 감싸고, 첫 줄에 언어 이름을 적으면 문법 하이라이트가 됩니다. 아래처럼 쓰면:

```ts → 코드 → ``` 로 감싼다는 뜻입니다.

→ 결과:

const greet = (name: string) => `안녕, ${name}`;

링크와 이미지

[링크 텍스트](https://koding.kr)
![이미지 설명](https://example.com/image.png)

이미지는 에디터에서 버튼·드래그·붙여넣기로 바로 올릴 수 있습니다. GitHub 동기화의 경우, 저장소 안의 상대경로 이미지 (![설명](images/a.png) 또는 [이미지: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개.

동기화 규칙

연결은 어디서 하나요?

헤더의 @내 계정 설정 · GitHub 연동 에서 저장소와 폴더를 지정하면 됩니다.