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

최근 수정 시각: 2026년 5월 30일 13:12

개요[편집]

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

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

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

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

기본 전제[편집]

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

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

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

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

처리 순서[편집]

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

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

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

`[나트랑 가라오케](/wiki/nhatrang-karaoke)`

원문 정규화[편집]

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

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

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

HTML 처리[편집]

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

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

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

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

위키링크[편집]

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

`[문서명](/wiki/%EB%AC%B8%EC%84%9C%EB%AA%85/edit?title=%EB%AC%B8%EC%84%9C%EB%AA%85&redlink=1)`
[표시할 글자](/wiki/%EB%AC%B8%EC%84%9C%EB%AA%85/edit?title=%EB%AC%B8%EC%84%9C%EB%AA%85&redlink=1)

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

[밤문화위키:편집지침](/wiki/wiki-editing-guide)
[밤문화위키:기본방침/문서 관리 방침](/wiki/wiki-basic-policy-document-management-2)

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

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

[나트랑 [[가라오케](/wiki/%EB%82%98%ED%8A%B8%EB%9E%91-%EA%B0%80%EB%9D%BC%EC%98%A4%EC%BC%80/edit?title=%EB%82%98%ED%8A%B8%EB%9E%91%20%5B%5B%EA%B0%80%EB%9D%BC%EC%98%A4%EC%BC%80&redlink=1)]]

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

마크다운 문단[편집]

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

## 개요
### 위치

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

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

목록과 인용문[편집]

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

- 항목
- 항목

1. 첫째
2. 둘째

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

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

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

각주[편집]

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

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

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

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

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

취소선[편집]

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

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

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

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

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

코드 블록[편집]

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

```markdown
[다낭 마사지](/wiki/danang-massage)
```

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

표[편집]

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

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

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

지원하지 않는 문법[편집]

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

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

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

렌더링과 승인 검수[편집]

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

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

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

구현 참고[편집]

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

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

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

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

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

이 문서는 2026년 5월 30일 13:12에 마지막으로 편집되었습니다.

여기를 가리키는 문서