이 문서는 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와 대표이미지 첨부) 하는 방식으로 해서 이미지 경로를 첨부할수 있음 상단 가본설정문구를 처럼 상대경로 사용가능함.
유튜브(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 등).
```jsconsole.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)
프로젝트 구조를 보여줄 때 유용합니다. bash나 text로 작성합니다.
작성예시 `기호를 3개 작성하고 옆에text나 bash로 표기하여 구조 작성하고 닫기
첫번째거는 test 두번째가 bash로 했을때
나라면 bash쓸듯
root/├── src/│ ├── content/│ │ └── posts/│ └── pages/├── public/└── package.jsonroot/├── src/│ ├── content/│ │ └── posts/│ └── pages/├── public/└── package.json깃허브 리포지토리 카드
특정 리포지토리를 카드 형태로 보여줍니다.
::github{repo="사용자명/리포지토리명"}스포일러 (숨김 텍스트)
클릭해야 보이는 텍스트입니다.
:spoiler[숨겨진 텍스트]7. 표 (Table)
| 항목 | 내용 | 비고 || :--- | :---: | ---: || 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 || A | B | C || 항목 | 내용 | 비고 |
|---|---|---|
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
| A | B | C |