> **[운영 문서]** 이 문서는 밤문화위키의 문법 처리와 렌더링 기준을 설명하는 운영 문서입니다.

## 개요

이 문서는 밤문화위키 문법을 개발·운영 관점에서 정리한 문서입니다. 일반 편집자는 [[밤문화위키:문법 도움말]]을 먼저 참고하면 됩니다.

밤문화위키는 나무위키식 전용 문법을 사용하지 않습니다. 기본 문법은 마크다운이며, 여기에 `[[위키링크]]`, 각주 `[^n]`, 취소선 `~~내용~~` 정도의 확장 문법만 허용합니다.

문법 처리의 목표는 다음과 같습니다.

- 익명 IP 또는 닉네임 편집자가 쉽게 제안할 수 있을 것
- 운영자가 승인 전후 내용을 검수하기 쉬울 것
- 모든 판이 리비전 히스토리에 안정적으로 남을 것
- 업소·여행 정보 문서에서도 과도한 장식보다 정보의 명확성을 우선할 것
- 문법이 [[밤문화위키:편집지침]]과 [[밤문화위키:기본방침]]을 우회하는 수단이 되지 않을 것

## 기본 전제

밤문화위키의 문서 원문은 승인 전 편집 제안 단계에서 저장될 수 있으며, 승인된 판만 실제 문서에 반영됩니다. 따라서 렌더러는 “작성자가 악의적이거나 실수할 수 있다”는 전제로 동작해야 합니다.

특히 다음 내용은 문법상 표현 가능하더라도 승인 대상이 아닙니다.

- 성매매 알선·중개·구체적 방법·가격 흥정 표현
- 특정 여성이나 종사자를 식별하거나 성적으로 묘사하는 표현
- 개인 신상 공개, 명예훼손, 모욕성 서술
- 미성년, 강요, 불법촬영과 관련된 내용
- 방문 전 직접 확인이 필요한 업소 정보를 확정 사실처럼 단정하는 표현

취소선도 예외가 아닙니다. `~~문제 표현~~`처럼 숨기듯 남긴 내용 역시 본문에 표시되는 서술로 보며, 방침 위반이면 반려하거나 수정해야 합니다.

## 처리 순서

밤문화위키의 권장 처리 순서는 다음과 같습니다.

1. 원문 정규화
2. 코드 블록과 인라인 코드 보호
3. HTML 및 위험 속성 제거
4. `[[위키링크]]` 해석
5. 마크다운 본문 렌더링
6. 각주 해석
7. 문단 앵커 생성
8. 렌더링 결과 검수 및 정책 필터 적용

코드 블록과 인라인 코드 안에서는 위키링크, 각주, 취소선 등을 해석하지 않습니다. 예를 들어 아래 문장은 코드 예시로만 보여야 합니다.

```markdown
`[[나트랑 가라오케]]`
```

## 원문 정규화

렌더링 전에는 줄바꿈, 공백, 제어문자 등을 정리합니다. 다만 문서 내용 자체를 임의로 바꾸면 리비전 비교가 어려워지므로, 의미가 달라지는 자동 치환은 피합니다.

권장 기준은 다음과 같습니다.

- 줄바꿈은 LF 기준으로 통일
- 보이지 않는 제어문자는 제거
- 과도한 빈 줄은 운영자 검수 단계에서 정리 가능
- 문서 제목과 슬러그는 별도 필드로 관리
- 원문 마크다운은 리비전 히스토리에 그대로 보존

## HTML 처리

일반 문서 본문에서는 HTML 직접 입력을 허용하지 않는 것을 원칙으로 합니다. 마크다운 렌더러가 HTML을 지원하더라도, 밤문화위키에서는 보안과 운영 일관성을 위해 제거하거나 이스케이프 처리합니다.

특히 다음 요소는 허용하지 않습니다.

- `<script>`, `<iframe>`, `<object>` 등 실행성 태그
- `onclick`, `onerror` 같은 이벤트 속성
- 추적용 픽셀, 자동 이동, 외부 스크립트
- 스타일 속성을 이용한 본문 은폐 또는 오인 유도

외부 링크가 필요한 경우 일반 마크다운 링크를 사용하되, 광고·홍보성 링크는 [[밤문화위키:문서 관리 방침]]에 따라 검수합니다.

## 위키링크

위키링크는 다음 형식을 기본으로 합니다.

```markdown
`[[문서명]]`
[[문서명|표시할 글자]]
```

운영 문서 링크는 다음처럼 이름공간을 포함합니다.

```markdown
[[밤문화위키:편집지침]]
[[밤문화위키:기본방침/문서 관리 방침]]
```

문서명에는 실제 문서 제목을 사용합니다. 업소 문서나 지역 문서의 명칭은 시간이 지나며 바뀔 수 있으므로, 별칭 처리는 렌더러보다 문서 관리 기능에서 처리하는 것이 좋습니다.

위키링크 안에서는 다시 위키링크를 중첩하지 않습니다.

```markdown
[[나트랑 [[가라오케]]]]
```

위와 같은 입력은 잘못된 문법으로 보거나 일반 텍스트에 가깝게 처리합니다.

## 마크다운 문단

문단 제목은 마크다운 heading을 사용합니다.

```markdown
## 개요
### 위치
```

문단 제목은 목차와 앵커 생성의 기준이 됩니다. 같은 제목이 여러 번 나오면 렌더러는 충돌을 피하기 위해 뒤쪽 앵커에 번호를 붙일 수 있습니다.

운영 문서에서는 제목을 짧고 직접적으로 작성합니다. 업소 문서에서도 “개요”, “위치”, “운영 정보”, “방문 전 확인”처럼 검수하기 쉬운 제목을 권장합니다.

## 목록과 인용문

목록은 표준 마크다운을 사용합니다.

```markdown
- 항목
- 항목

1. 첫째
2. 둘째
```

인용문은 운영 안내나 주의문에 사용할 수 있습니다.

```markdown
> 방문 전 영업 여부와 가격은 직접 확인하는 것이 좋습니다.
```

다만 인용문을 이용해 검증되지 않은 후기, 신상 정보, 불법적 안내를 강조해서는 안 됩니다.

## 각주

각주는 다음 형식을 사용합니다.

```markdown
본문 내용입니다.[^1]

[^1]: 출처 또는 보충 설명입니다.
```

각주는 출처와 보충 설명을 위해 사용합니다. 본문에서 금지되는 내용은 각주에서도 금지됩니다.

업소 정보의 경우 각주가 있어도 최신성을 보장하지 않습니다. 영업시간, 가격, 서비스 구성, 예약 방식 등은 수시로 바뀔 수 있으므로 “방문 전 직접 확인” 원칙을 유지해야 합니다.

## 취소선

취소선은 다음 형식을 사용합니다.

```markdown
~~더 이상 쓰지 않는 표현~~
```

취소선은 가벼운 정정이나 문맥상 필요한 표현에만 제한적으로 사용합니다. 다음 용도로 사용할 수 없습니다.

- 명예훼손성 표현을 남기는 용도
- 특정 개인의 신상이나 외모 묘사를 숨기는 용도
- 불법 서비스 안내를 “농담”처럼 남기는 용도
- 운영자 검수를 피하기 위한 암시 표현

문서의 신뢰성을 위해, 운영 문서에서는 취소선 사용을 최소화합니다.

## 코드 블록

문법 설명이나 예시에는 코드 블록을 사용할 수 있습니다.

````markdown
```markdown
[[다낭 불건마]]
```
````

코드 블록 안의 내용은 렌더링하지 않습니다. 따라서 코드 블록 안에 있는 `[[위키링크]]`나 `[^1]`은 실제 링크나 각주가 되지 않아야 합니다.

## 표

표는 표준 마크다운 표를 사용할 수 있습니다.

```markdown
| 항목 | 설명 |
| --- | --- |
| 영업시간 | 방문 전 확인 필요 |
| 위치 | 지도 또는 공식 채널 확인 |
```

업소 문서에서 표를 사용할 때는 확정적으로 보이는 표현을 주의해야 합니다. 가격, 예약, 서비스 구성은 변경 가능성이 높으므로 최신 확인이 필요하다는 문구를 함께 두는 것이 좋습니다.

## 지원하지 않는 문법

밤문화위키에서는 다음 문법을 사용하지 않습니다.

- 나무위키식 표 문법
- 나무위키식 굵게·색상·크기 문법
- 분류 매크로
- include 매크로
- 접기 매크로
- HTML 삽입 문법
- 위키 엔진 전용 매크로

이런 문법이 입력되면 자동 변환하지 않고 일반 텍스트로 보이게 하거나, 승인 과정에서 운영자가 마크다운 문법으로 고칩니다.

## 렌더링과 승인 검수

문법 렌더링은 문서 표시를 위한 기술 처리일 뿐, 편집 승인 자체를 대체하지 않습니다. 승인자는 다음을 함께 확인해야 합니다.

- 문법이 깨져 문서 의미가 달라지지 않았는지
- 링크가 실제 관련 문서로 연결되는지
- 외부 링크가 광고·피싱·불법 안내로 이어지지 않는지
- 업소 정보가 단정적으로 쓰이지 않았는지
- 안전선 위반 내용이 본문, 각주, 링크 텍스트, 취소선에 포함되지 않았는지

문법적으로 올바른 문장이라도 [[밤문화위키:편집지침]]에 맞지 않으면 반려하거나 수정 후 승인합니다.

## 구현 참고

렌더러 구현 시에는 가능한 한 표준 마크다운 파서를 사용하고, 밤문화위키 고유 기능은 얇은 확장으로 유지합니다.

권장 구조는 다음과 같습니다.

```text
원문
→ 코드 영역 보호
→ 위험 HTML 제거
→ 위키링크 토큰화
→ 마크다운 렌더링
→ 각주 정리
→ 링크 검증
→ 최종 HTML 출력
```

문법 확장은 운영 규모에 맞게 신중히 추가합니다. 기능이 많아질수록 편집자는 복잡한 문법을 외워야 하고, 운영자는 승인 검수에서 더 많은 예외를 처리해야 합니다.

밤문화위키의 문법은 화려한 표현보다 정확한 정보 전달과 안전한 운영을 우선합니다.