AI 초안의 인라인 코드 검수: 백틱 안에서는 별표·태그를 글자로 읽습니다
AI 초안에 백틱으로 감싼 짧은 구절이 있다면 그 안의 별표나 태그를 일반 본문처럼 해석하지 마세요. CommonMark의 인라인 코드에서는 내용을 코드 구간으로 읽습니다. 별표로 감쌌다고 기울임이 되거나 HTML 태그가 곧바로 적용되는 문맥이 아닙니다.
기준은 CommonMark 0.31.2, 6.1 Code spans입니다. 실제 게시 도구가 같은 Markdown 규칙을 지원하는지는 별도로 미리보기에서 확인합니다.
1. 시작과 끝의 백틱 길이를 먼저 맞추기
인라인 코드 구간은 같은 길이의 백틱 묶음으로 열고 닫습니다. 짧은 구절을 감싸는 일반적인 한 개짜리 백틱만 기억하면, 내용 자체에 백틱이 들어가는 예시를 잘못 고칠 수 있습니다.
검수할 때는 여는 기호와 닫는 기호를 먼저 찾고 그 사이를 한 덩어리로 봅니다. 내용에 백틱이 필요하면 더 긴 구분자를 쓰는 방법을 사양에서 확인할 수 있습니다. 본문에서 백슬래시를 붙이면 해결될 것이라고 가정하지 마세요. 코드 구간 안에서는 일반적인 백슬래시 이스케이프가 처리되지 않습니다.
2. 비슷한 문자열 두 개를 구분하기
| 작성한 문자열 | CommonMark에서 확인할 것 | 검수 질문 |
|---|---|---|
| *보류* | 일반 본문에서는 강조 구문 | 강조를 의도했는가 |
| `*보류*` | 별표까지 코드 내용으로 표시 | 별표가 보이는 것이 오류인가 |
| `<em>대기</em>` | 태그 문자를 코드 내용으로 표시 | 태그 적용을 기대하고 있지는 않은가 |
| `a b` | 코드 구간 내부의 연속 공백 | 게시 도구의 실제 표시를 확인했는가 |
표의 예시는 자체 검수용입니다. 원문 문자열과 결과 화면을 나란히 확인해 의도와 다른 부분만 수정하세요. 코드 안의 문장 부호를 문체 교정 대상으로 일괄 삭제하면 설명하려던 문법 예시를 망칠 수 있습니다.
3. 줄바꿈과 양 끝 공백도 결과에 영향을 줍니다
CommonMark의 코드 구간은 줄 끝을 공백으로 바꿉니다. 양 끝에 공백이 하나씩 있고 내용 전체가 공백만으로 이루어지지 않았다면 양쪽 공백을 하나씩 제거하는 규칙도 있습니다. 여러 줄로 입력했다고 줄이 그대로 나뉘어 보일 것이라고 가정하지 않습니다.
이 차이가 중요한 예시라면 짧은 문자열부터 렌더링해 비교하세요. 긴 코드나 줄 구조가 핵심인 설명은 인라인 구간에 억지로 넣지 말고 사용 도구의 코드 블록 기능을 확인합니다. 인라인 코드와 코드 블록은 별도 문맥입니다.
4. AI 초안을 검수하는 네 단계
① 설명 문장과 코드 예시의 경계를 표시합니다.
② 백틱의 시작·끝 길이와 내용 속 백틱을 확인합니다.
③ 기대한 화면을 한 줄로 적습니다. 예: ‘별표 두 개가 그대로 보여야 함’.
④ 실제 게시 도구의 미리보기와 공개 결과를 비교합니다.
가상 사례: 초안이 *보류*라는 문법 예시를 설명하려는데 편집자가 별표를 모두 지우면 원래 설명과 결과가 달라집니다. 반대로 실제 강조가 목적이라면 코드 구간에 가둬 둔 것이 맞는지 검토해야 합니다. 어느 쪽이든 겉모양만 보고 자동 치환하지 않는 것이 핵심입니다.
코드처럼 표시된다는 사실은 그 명령이나 프로그램이 실행됐다는 증거가 아닙니다. 실행 결과, 링크 작동, 데이터 검증은 각각 별도 확인이 필요합니다.
5. 자주 묻는 질문
백틱 안의 별표는 왜 기울임이 안 되나요?
인라인 코드 내용으로 읽는 구간이기 때문입니다.
백슬래시를 붙이면 코드 안에서도 기호를 숨길 수 있나요?
CommonMark 코드 구간에는 일반적인 백슬래시 이스케이프가 적용되지 않습니다. 필요한 구분자 길이를 확인하세요.
모든 블로그 편집기가 똑같이 보이나요?
지원 문법과 표시 스타일이 다를 수 있습니다. 해당 도구의 미리보기와 실제 결과를 확인해야 합니다.
자료 확인: 2026년 10월 10일. CommonMark 0.31.2 · 6.1 Code spans
검수 표와 가상 사례는 자체 구성했습니다. 코드 실행 결과를 보고한 글이 아닙니다.
대표 썸네일은 이해를 돕기 위해 AI로 제작한 삽화입니다.
댓글
댓글 쓰기