이 포스트는 링크로만 볼 수 있는 설명글입니다.#

🔍 미등록(Unlisted)’ 기능이란 무엇인가요?#

unlisted 기능은 특정 게시물을 공개적인 목록에서 숨기면서도, 직접적인 URL 주소를 통해서는 접근할 수 있게 해줍니다. 블로그 메인 피드를 어지럽히지 않고 특정 소수에게만 콘텐츠를 공유하고 싶을 때 사용하기에 완벽한 기능입니다.

🛠️ 사용 방법#

포스트(.md파일) 상단의 frontmatter에 unlisted: true 속성을 추가하기만 하면 됩니다.

1
---
2
title: "비밀 포스트에요!"
3
published: 2026-01-18
4
unlisted: true
5
---

미등록 포스트는 어디에서 숨겨지나요?#

포스트가 unlisted: true로 설정되면 다음 목록에 나타나지 않습니다.

• 🏠홈페이지 게시물 목록
• 📂Archive 페이지
• 🏷️태그 및 카테고리 목록
• 🔍검색 결과 (Pagefind)
• 📡RSS 피드

미등록 포스트에 접속하는 방법#

미등록 포스트는 오직 URL을 통해서만 접속할 수 있습니다. URL은 다음과 같은 표준 패턴을 따릅니다.

https://your-site.com/posts/[포스트-슬러그]/

예시: 파일명이 unlisted-sample.md이고 사이트 주소가 https://csrf.blog이라면, 접속 URL은 다음과 같습니다: https://csrf.blog/posts/unlisted-sample/

⚠️ 보안 주의사항: 미등록 ≠ 비공개#

이 기능은 ‘검색 제외’를 통한 숨김 기능을 제공하는 것이지, 절대적인 보안을 제공하는 것은 아닙니다. 직접적인 링크를 알고 있는 사람이라면 누구나 콘텐츠를 볼 수 있습니다. 민감한 정보에 대한 접근을 엄격히 제한해야 한다면 서버 수준의 인증(예: Basic Auth 또는 미들웨어)을 사용하시기 바랍니다.

💡 활용 사례#

• 초안 리뷰: 거의 완성된 포스트를 친구나 동료에게 공유하여 피드백을 받고 싶을 때.
• 특정 대상 콘텐츠: 특정 그룹만을 위한 전용 가이드나 글을 작성할 때.
• 깔끔한 피드 유지: 짧은 메모나 실험적인 글들이 메인 아카이브 목록을 어지럽히지 않도록 하고 싶을 때.