855 단어
4 분
게시글 작성 완벽 가이드

이 문서는 Fuwari 테마에서 게시글을 작성할 때 사용할 수 있는 다양한 마크다운 문법과 기능을 설명합니다.

1. 기본 설정 (Frontmatter)#

파일의 맨 처음에 위치하는 설정 영역입니다.

---
title: 제목
published: 2026-02-03 # 발행일
description: '글 요약'
image: './cover.jpg' # 대표 이미지 경로 (선택)
tags: [태그1, 태그2]
category: '카테고리'
draft: false # true일 경우 배포 시 숨김
---

2. 텍스트 서식#

기본적인 마크다운 문법을 모두 지원합니다.

  • 굵게: **텍스트**
  • 기울임: *텍스트*
  • 취소선: ~~텍스트~~
  • 링크: [링크 텍스트](URL)

3. 이미지 및 미디어 첨부#

이미지#

이미지 파일을 src/assets/images 폴더나 public/images 폴더에 넣고 경로를 지정합니다. public 폴더에 넣은 경우 /images/파일명.png 처럼 절대 경로로 접근 가능합니다.

대표이미지 설정이나 다른 이미지 처리방법으로는 posts/[새로운파일명]/(index.md와 대표이미지 첨부) 하는 방식으로 해서 이미지 경로를 첨부할수 있음 상단 가본설정문구를 처럼 상대경로 사용가능함.

![이미지 설명](/assets/images/demo-banner.png)

유튜브(YouTube) 영상#

유튜브 영상은 <iframe> 태그를 사용하여 삽입합니다. 유튜브 ‘공유 -> 퍼가기’ 메뉴에서 코드를 복사하면 됩니다.

<iframe width="100%" height="468" src="https://www.youtube.com/embed/VIDEO_ID" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

4. 코드 블록 (Expressive Code)#

이 테마는 강력한 코드 블록 기능을 제공합니다.

기본 사용법#

언어 이름을 뒤에 적어주세요 (js, ts, python, html 등).

```js
console.log('Hello World');
```

제목 표시#

파일 제목을 표시할 수 있습니다.

```js title="app.js"
console.log('File title example');
```

줄 강조 및 라인 넘버#

  • showLineNumbers: 줄 번호 표시
  • {1, 3-4}: 특정 줄 강조
  • ins={2}, del={3}: 추가/삭제 표시 (Diff 스타일)
```js showLineNumbers {1} ins={3} del={4}
function test() {
console.log('Highlighted line');
console.log('Added line');
console.log('Deleted line');
}
```

5. 인용구 및 알림 (Admonitions)#

중요한 정보를 강조할 때 사용합니다.

NOTE

이것은 일반적인 메모입니다.

TIP

유용한 팁을 작성할 때 사용하세요.

WARNING

주의사항을 알릴 때 사용합니다.

CAUTION

경고 메시지입니다.

IMPORTANT

중요한 정보입니다.

작성 방법:

:::tip
내용을 작성하세요.
:::

GitHub 스타일 알림#

> [!NOTE]
> GitHub 스타일의 알림도 지원합니다.

6. 기타 유용한 기능#

파일 구조 (File Tree)#

프로젝트 구조를 보여줄 때 유용합니다. bashtext로 작성합니다. 작성예시 `기호를 3개 작성하고 옆에text나 bash로 표기하여 구조 작성하고 닫기 첫번째거는 test 두번째가 bash로 했을때 나라면 bash쓸듯

root/
├── src/
│ ├── content/
│ │ └── posts/
│ └── pages/
├── public/
└── package.json
Terminal window
root/
├── src/
├── content/
└── posts/
└── pages/
├── public/
└── package.json

깃허브 리포지토리 카드#

특정 리포지토리를 카드 형태로 보여줍니다.

wlzerd
/
fuwari
Waiting for api.github.com...
00K
0K
0K
Waiting...
::github{repo="사용자명/리포지토리명"}

스포일러 (숨김 텍스트)#

클릭해야 보이는 텍스트입니다. 이 내용은 비밀입니다!

:spoiler[숨겨진 텍스트]

7. 표 (Table)#

| 항목 | 내용 | 비고 |
| :--- | :---: | ---: |
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
| A | B | C |
항목내용비고
왼쪽 정렬가운데 정렬오른쪽 정렬
ABC
게시글 작성 완벽 가이드
https://catdev.space/posts/writing-guide/
저자
검은고양이
게시일
2026-02-03
라이선스
CC BY-NC-SA 4.0