URL path가 폴더명처럼 보일 때, 폴더 전체를 불러오는 것일까? & md(markdown) 파일 렌더링 방식

URL 경로에서 마지막 부분이 파일명이 아니라 폴더명으로 보일 때 그것이 의미하는 것을 설명해줄게!

---

✅ 1. URL 끝이 폴더명처럼 보일 때, 실제로는 “폴더 전체를 불러오는 것일까?”

반쯤 맞고, 반쯤 틀려.

예:
https://kakaobusiness.gitbook.io/main/tool/pixel-sdk

이 URL에서 pixel-sdk는 폴더명처럼 보이지만, 실제로 웹 서버에서는 다음 중 하나를 의미할 수 있어:

① 폴더 안의 기본(index) 문서를 자동으로 로드하는 것

웹 서버는 보통 폴더를 요청하면 다음 파일 중 하나를 자동으로 반환해:

• index.html
• index.htm
• index.md (문서 기반 사이트일 경우)
• GitBook에서는 README.md일 수도 있음

즉,
폴더 전체를 불러오는 것이 아니라, 그 '폴더 안의 대표 문서'를 불러오는 것!

---

✅ 2. GitBook의 경우는 좀 다르다

너가 준 URL은 GitBook 기반 문서 사이트야.

GitBook에서는 폴더 구조는 실제 파일시스템이 아니라,
문서 구조(SUMMARY.md) 기반 “가상의 문서 라우팅”이야.

 

즉,

• /pixel-sdk → Pixel SDK 문서 페이지 하나
• 실제로는 백엔드에서 pixel-sdk.md나 README.md 같은 단일 문서를 렌더링하여 보여주는 것

➡ GitBook에서는 폴더 전체가 아니라, 특정 문서를 라우팅하는 URL이야.

728x90

 

Q. .md(MarkDown) 문서는 HTML처럼 태그로 구성된 파일이 아닌데, 어떻게 화면에 렌더링되는가?

.md(Markdown) 같은 문서는 HTML처럼 태그로 구성된 파일이 아닌데, 어떻게 화면에 렌더링되는지 궁금한 거지?

정확하게 설명해줄게.

---

✅ 1. .md 파일은 “그대로” 보여주는 게 아니라 HTML로 변환해서 보여준다

Markdown은 웹 브라우저가 바로 렌더링할 수 없어.
그래서 GitBook, GitHub, Notion, 개발 문서 사이트 등은 모두 다음 과정을 거쳐:

Markdown → HTML 변환 → 브라우저 렌더링

예시:

Markdown 원문

# Pixel SDK 문서
설치 방법:
- npm install pixel-sdk

변환 후 HTML

<h1>Pixel SDK 문서</h1>
<p>설치 방법:</p>
<ul>
 <li>npm install pixel-sdk</li>
</ul>

브라우저는 HTML을 이해하니까 이렇게 화면에 깔끔하게 나타나는 것.

---

✅ 2. GitBook은 .md 문서를 실시간으로 HTML로 렌더링해주는 시스템

너가 본 페이지:

https://kakaobusiness.gitbook.io/main/tool/pixel-sdk

 

이 URL은 실제로:

• pixel-sdk.md 파일을 서버에서 읽고
• GitBook 렌더러가 HTML 구조로 변환하고
• 스타일(CSS)까지 입혀서
• 완성된 HTML을 브라우저에 보내는 것

즉, 내부적으로는 다음과 같아:

<h1>Pixel SDK 문서</h1>
<p>설치 방법:</p>
<ul>
  <li>npm install pixel-sdk</li>
</ul>

---

✅ 3. 일반 웹서버에서도 Markdown을 직접 보여주지 않는다

정적 웹 서버(Nginx, Apache)에 README.md만 올려두면

그냥 텍스트 파일 그대로 다운로드되거나, 텍스트로 노출될 뿐이야.

 

Markdown이 예쁘게 보이는 건 다음 같은 시스템이 있기 때문:

• GitHub
• GitLab
• GitBook
• Notion
• MkDocs
• Docusaurus
• Jekyll
• Hugo

이런 플랫폼은 모두 Markdown → HTML 렌더러가 내장되어 있어.

---

✅ 4. 요약

파일	브라우저가 바로 렌더링?	어떻게 보여줌?
.html	O (바로 렌더링)	태그 그대로 해석
.md	X (직접 렌더링 불가)	서버/프레임워크가 HTML로 변환 후 보여줌

---

🔍 필요하면 Markdown 렌더링 방식(파서, AST, GitBook의 빌드 구조 등)도 더 깊게 설명해줄까?

---

✅ 3. 정리

URL 형태	실제 의미
/folder/	서버가 folder/index.html 같은 기본 문서를 자동으로 보여줌
/folder/subfolder/	역시 기본 문서 자동 로드
/pixel-sdk (GitBook 등)	특정 문서 하나를 라우팅한 URL (폴더가 아님)

---

🔍 즉, 네가 본 URL은 폴더 전체를 불러오는 게 아니라 “폴더명처럼 보이는 문서 하나”에 접근하는 것!

원하면

• 폴더 구조가 URL에 어떻게 반영되는지
• GitBook의 라우팅 방식
• 웹 서버의 index 파일 동작 방식
  등을 더 자세히 설명해줄까?