포스트 작성하기#

Hugo에서 새로운 포스트를 작성하는 방법을 알아봅니다.

새 포스트 생성#

Hugo CLI를 사용하여 새 포스트를 생성할 수 있습니다:

# 한국어 포스트 생성
hugo new content.ko/docs/my-first-post.md

# 영어 포스트 생성
hugo new content.en/docs/my-first-post.md

각 포스트의 상단에는 메타데이터를 정의하는 Front Matter가 있습니다.

---
title: "포스트 제목"
date: 2025-12-19T20:00:00+09:00
weight: 10
bookToc: true
---

검색과 SEO를 위한 추가 메타데이터:

---
title: "포스트 제목"
description: "포스트에 대한 간단한 설명"
tags: ["hugo", "블로그", "웹개발"]
categories: ["튜토리얼"]
author: "작성자명"
---

Hugo는 표준 마크다운과 확장 기능을 지원합니다.

# H1 제목
## H2 제목
### H3 제목

**굵게**
*기울임*
~~취소선~~
`인라인 코드`

[링크 텍스트](https://example.com)
![이미지 설명](/images/photo.jpg)

```python
def hello():
    print("Hello, Hugo!")
```

- 항목 1
- 항목 2
  - 하위 항목

1. 순서 항목 1
2. 순서 항목 2

> 인용문 내용

| 컬럼1 | 컬럼2 |
|-------|-------|
| 내용1 | 내용2 |

hugo-book 테마는 유용한 shortcode를 제공합니다.

{{< hint info >}}
정보 메시지
{{< /hint >}}

{{< hint warning >}}
경고 메시지
{{< /hint >}}

{{< hint danger >}}
위험 메시지
{{< /hint >}}

{{< button relref="/" >}}홈으로{{< /button >}}
{{< button href="https://example.com" >}}외부 링크{{< /button >}}

{{< columns >}}

## 왼쪽 컬럼
내용...

<--->

## 오른쪽 컬럼
내용...

{{< /columns >}}

{{< tabs "unique-id" >}}
{{< tab "탭1" >}} 탭1 내용 {{< /tab >}}
{{< tab "탭2" >}} 탭2 내용 {{< /tab >}}
{{< /tabs >}}

{{< details "제목" >}}
펼쳐지는 내용
{{< /details >}}

이미지는 static 디렉토리에 저장합니다:

static/
  images/
    photo.jpg
    logo.png

마크다운에서 참조:

![설명](/images/photo.jpg)

작성 중인 포스트는 draft로 설정할 수 있습니다:

---
title: "작성 중인 포스트"
draft: true
---

Draft 포스트를 포함하여 서버 실행:

hugo server --buildDrafts

로컬에서 포스트를 미리 확인:

hugo server

브라우저에서 http://localhost:1313 접속