BBCode를 HTML로

BBCode를 HTML로는 포럼 편집기 밖에서도 사용할 수 있도록 BBCode 조각을 원시 HTML로 변환하는 무료 도구입니다.

BBCode를 변환하면 어떤 문제가 해결되나요?

BBCode 변환은 포럼용 마크업을 브라우저, 콘텐츠 관리 시스템, 웹 템플릿이 해석할 수 있는 HTML로 바꿉니다. BBCode는 HTML 요소 대신 [b], [i], [url] 같은 대괄호 태그를 사용합니다.

포럼 게시물을 이전하거나, 서드파티 API가 반환한 콘텐츠를 디버깅하거나, BBCode는 지원하지 않고 HTML만 허용하는 플랫폼에 오래된 지식 베이스를 옮길 때 유용합니다. 가져온 텍스트를 배포 전에 주변 애플리케이션 코드와 분리해 점검해야 할 때도 활용할 수 있습니다.

BBCode는 정식으로 표준화된 단일 언어가 아닙니다. 포럼 소프트웨어와 플러그인마다 자체 태그, 속성, 중첩 규칙을 정의할 수 있습니다. 따라서 일반적인 서식은 문제없이 변환되더라도, 원본에 스포일러 상자, 첨부 파일 참조, 사용자 정의 미디어 태그처럼 특정 플랫폼에서만 쓰는 구문이 포함되어 있으면 결과를 조정해야 할 수 있습니다.

BBCode를 HTML로 어떻게 변환하나요?

원본 마크업을 BBCode 필드에 입력하거나 붙여 넣은 다음, HTML 필드에서 변환된 코드를 확인하세요. 요소와 링크가 의도한 콘텐츠와 일치하는지 점검한 뒤에만 HTML을 대상 위치에 복사하세요.

1. 여는 태그와 닫는 태그를 포함한 전체 BBCode 조각을 복사하세요.
2. 대괄호를 바꾸지 말고 BBCode 필드에 넣으세요.
3. HTML 필드에서 원시 결과를 확인하세요.
4. 링크, 이미지, 목록, 중첩된 서식을 원본 게시물과 비교하세요.
5. 신뢰할 수 없는 출력은 공개 페이지에 렌더링하기 전에 정화하세요.

변환은 서버에서 실행됩니다. 입력한 내용은 HTTPS를 통해 서버로 전송되며 저장되지 않습니다.

변환된 HTML은 어떻게 확인해야 하나요?

결과는 시각적 미리보기가 아니라 소스 코드로 확인하세요. 반환된 HTML에는 원본 BBCode의 구조와 서식을 나타내는 요소가 포함되어야 합니다.

간단한 개념적 예시는 다음과 같습니다.

BBCode 입력: [b]Release note[/b]

HTML 출력: "Release note"라는 텍스트를 포함하는 굵게 표시하는 HTML 요소 또는 strong HTML 요소.

또 다른 일반적인 패턴은 다음과 같습니다.

BBCode 입력: [url=https://example.org/docs]Read the docs[/url]

HTML 출력: 대상 주소가 https://example.org/docs이고 화면에 표시되는 텍스트가 "Read the docs"인 앵커 요소.

BBCode 문법은 표준화되어 있지 않으므로 변환기마다 정확한 요소 이름이 다를 수 있습니다. 예를 들어 굵은 텍스트는 중요성을 추가로 나타내지 않고 주의를 끄는 b 요소로 표현될 수도 있고, 높은 중요도를 나타내는 strong 요소로 표현될 수도 있습니다. 특정 매핑을 가정하지 말고 HTML 필드의 실제 값을 확인하세요.

이 도구는 변환기이며 HTML 유효성 검사기나 보안 정화 도구를 대신하지 않습니다. BBCode가 변환되지 않고 그대로 남거나, 콘텐츠가 누락되거나, 요소가 이상하게 중첩되어 있다면 원본에 잘못된 구문 또는 지원되지 않는 구문이 있다는 신호로 보세요. 흔한 원인으로는 닫히지 않은 태그, 순서가 잘못된 닫는 태그, 잘못 작성된 속성, 일반적인 HTML 대응 요소가 없는 포럼 전용 태그가 있습니다.

처리하기 까다로운 입력과 문법 차이

공백, 문장 부호, 숫자, 악센트 문자가 포함된 글자, 비라틴 문자권의 글자는 태그 구문이나 속성 안에 있지 않은 한 일반 텍스트입니다. 별도의 마크업으로 바뀌지 않고 콘텐츠로 유지되어야 합니다. URL은 좀 더 주의해야 합니다. 공백처럼 URL의 일부인 문자는 퍼센트 인코딩이 필요할 수 있고, 앰퍼샌드나 따옴표처럼 주변 HTML 속성 구문에서 특별한 의미를 갖는 문자는 HTML 이스케이프가 필요할 수 있습니다.

• 잘못된 중첩: [b][i]Text[/b][/i]는 태그를 잘못된 순서로 닫습니다. 올바르게 중첩된 마크업은 안쪽 태그부터 닫습니다.
• 누락된 닫는 태그: [quote]Text에서 마지막 태그가 빠지면 이에 대응하는 닫는 태그가 없습니다.
• 사용자 정의 태그: [spoiler], [video], 첨부 파일 태그는 포럼 소프트웨어에 따라 의미가 다를 수 있습니다.
• 기존 HTML: BBCode에 섞인 HTML은 파서에 따라 이스케이프되거나, 유지되거나, 텍스트로 처리될 수 있습니다. 하나의 공통 규칙에 의존하지 말고 결과를 주의 깊게 확인하세요.
• 매우 긴 입력: 대규모 이전 작업은 일반적으로 여러 배치로 나누어 처리하는 편이 좋습니다. 그래야 실패한 레코드를 찾아 수정하기 쉽습니다.

빈 입력에는 변환할 서식 구조가 없습니다. 원본이 BBCode 태그 없는 일반 텍스트라면 변환의 이점이 거의 없을 수 있습니다. 다만 이후 HTML 처리 과정에서는 <, >, & 같은 문자를 이스케이프해야 할 수 있습니다.

변환할 필요가 없는 경우는 언제인가요?

콘텐츠를 읽는 시스템이 원본 BBCode 문법을 이미 이해한다면 변환할 필요가 없습니다. 형식을 바꾸면 변환 단계가 하나 더 생기고 포럼의 사용자 정의 동작이 사라질 수 있습니다.

기계가 BBCode를 변경하지 않은 채 저장한 뒤 같은 포럼 엔진으로 렌더링할 때도 변환은 불필요합니다. 마찬가지로 생성된 HTML을 기계만 읽는다면 보기 좋게 정리하거나 수동으로 재배치해도 얻는 이점이 거의 없습니다. 단, 버전 관리 검토나 디버깅을 위해 코드 정리가 필요한 경우는 예외입니다.

대량 이전에는 스크립트 기반 파서가 더 적합할 수 있습니다. 모든 레코드에 동일한 문법 규칙을 적용하고 실패 내역을 기록할 수 있기 때문입니다. 중첩된 마크업을 정규식만으로 처리하는 것은 위험합니다. 중첩, 속성, 잘못된 입력을 이해하는 파서를 사용한 다음, 생성된 HTML의 유효성을 별도로 검사하고 정화하세요. 변환된 콘텐츠에 내장 JSON 설정이 포함되어 있다면 JSON 유효성 검사기 및 포매터로 해당 데이터를 살펴볼 수 있지만, 주변 HTML의 유효성까지 검사하지는 않습니다.

자주 묻는 질문

변환한 BBCode를 바로 게시해도 안전한가요?

아니요. 신뢰할 수 없는 포럼 게시물에서 생성한 HTML은 렌더링하기 전에 허용 목록 기반 HTML 정화 도구를 거쳐야 합니다. 링크, 이미지, 내장 미디어가 있거나 원본에 이미 HTML과 유사한 텍스트가 포함되어 있을 수 있다면 특히 중요합니다.

줄바꿈도 HTML 문단으로 바뀌나요?

줄바꿈 처리 방식은 BBCode 파서와 원본 플랫폼의 규칙에 따라 달라집니다. 빈 줄을 문단으로 처리하는 시스템도 있고, 줄바꿈 요소를 삽입하거나 일반 공백을 그대로 유지하는 시스템도 있습니다. 대량의 콘텐츠를 이전하기 전에 여러 줄로 된 예시를 원래 포럼의 렌더링 결과와 비교하세요.

BBCode에서 유니코드 문자를 사용할 수 있나요?

BBCode에는 악센트 문자, 이모지, 비라틴 문자권의 글자를 비롯한 유니코드 텍스트를 넣을 수 있습니다. 이런 문자는 태그 구문이 아니라 콘텐츠이기 때문입니다. 대상 페이지도 일반적으로 UTF-8 같은 적절한 문자 인코딩을 사용해야 합니다. 그렇지 않으면 변환 후 텍스트가 잘못 표시될 수 있습니다.

CSV나 데이터베이스 내보내기 파일 안의 BBCode도 변환할 수 있나요?

내보내기 파일 전체가 아니라 필드 값만 변환하세요. CSV 따옴표 처리, 구분 기호, 데이터베이스 이스케이프 시퀀스는 컨테이너 형식의 일부이므로 마크업 변환기에 넣으면 손상될 수 있습니다. 변경하지 않은 백업을 보관하고, 모든 행에 변환을 적용하기 전에 작은 배치부터 처리하세요.

HTML을 가져오기 전에 무엇을 확인해야 하나요?

중첩된 서식, 링크, 목록, 이미지 참조, 원본 포럼에서 사용한 사용자 정의 태그가 포함된 예시를 확인하세요. 대상 시스템이 해당 HTML 요소와 속성을 허용하는지 확인한 다음, 전체 가져오기를 실행하기 전에 대상 시스템에서 요구하는 정화 또는 유효성 검사 단계를 진행하세요.