밤문화위키:문법 도움말/개발 r2

2026-05-30 22:12 판

편집운영자 (관리자)

항목 보강

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

개요

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

밤문화위키는 나무위키식 전용 문법을 사용하지 않습니다. 기본 문법은 마크다운이며, 여기에 [위키링크](/wiki/%EC%9C%84%ED%82%A4%EB%A7%81%ED%81%AC), 각주 [^n], 취소선 ~~내용~~ 정도의 확장 문법만 허용합니다.

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

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

기본 전제

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

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

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

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

처리 순서

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

원문 정규화
코드 블록과 인라인 코드 보호
HTML 및 위험 속성 제거
[위키링크](/wiki/%EC%9C%84%ED%82%A4%EB%A7%81%ED%81%AC) 해석
마크다운 본문 렌더링
각주 해석
문단 앵커 생성
렌더링 결과 검수 및 정책 필터 적용

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

`[나트랑 가라오케](/wiki/%EB%82%98%ED%8A%B8%EB%9E%91-%EA%B0%80%EB%9D%BC%EC%98%A4%EC%BC%80)`

원문 정규화

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

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

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

HTML 처리

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

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

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

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

위키링크

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

`[문서명](/wiki/%EB%AC%B8%EC%84%9C%EB%AA%85)`
[표시할 글자](/wiki/%EB%AC%B8%EC%84%9C%EB%AA%85)

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

[밤문화위키:편집지침](/wiki/%EB%B0%A4%EB%AC%B8%ED%99%94%EC%9C%84%ED%82%A4-%ED%8E%B8%EC%A7%91%EC%A7%80%EC%B9%A8)
[밤문화위키:기본방침/문서 관리 방침](/wiki/%EB%B0%A4%EB%AC%B8%ED%99%94%EC%9C%84%ED%82%A4-%EA%B8%B0%EB%B3%B8%EB%B0%A9%EC%B9%A8-%EB%AC%B8%EC%84%9C-%EA%B4%80%EB%A6%AC-%EB%B0%A9%EC%B9%A8)

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

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

[나트랑 [[가라오케](/wiki/%EB%82%98%ED%8A%B8%EB%9E%91-%EA%B0%80%EB%9D%BC%EC%98%A4%EC%BC%80)]]

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

마크다운 문단

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

## 개요
### 위치

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

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

목록과 인용문

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

- 항목
- 항목

1. 첫째
2. 둘째

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

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

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

각주

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

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

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

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

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

취소선

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

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

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

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

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

코드 블록

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

```markdown
[다낭 마사지](/wiki/%EB%8B%A4%EB%82%AD-%EB%A7%88%EC%82%AC%EC%A7%80)
```

코드 블록 안의 내용은 렌더링하지 않습니다. 따라서 코드 블록 안에 있는 [위키링크](/wiki/%EC%9C%84%ED%82%A4%EB%A7%81%ED%81%AC)나 [^1]은 실제 링크나 각주가 되지 않아야 합니다.

표

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

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

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

지원하지 않는 문법

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

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

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

렌더링과 승인 검수

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

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

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

구현 참고

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

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

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

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

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