마크다운 언더라인 — 되는 환경과 대안

렌더러가 HTML을 벗길 때, 네 가지 대안이 거의 모든 필요를 덮습니다. 굵게는 보편적 강조이고 어떤 렌더러도 버리지 않습니다. 기울임은 그 가벼운 형제입니다. 코드 범위는 선 대신 색이 입은 배경으로 용어를 부각합니다. 그리고 밑줄 글리프가 정말 필요한 문서 — 인쇄되는 계약서, 중국어 고유명사 — 를 위해서는, 마크다운 PDF 변환 페이지에서 완성된 문서를 PDF로 내보내고, 타이포그래피가 렌더러가 아니라 여러분의 통제 아래 있는 목적지에서 스타일을 적용하세요.

더 섬세한 전략은 구조적입니다. 파이프라인을 통제할 수 있다면, u를 화이트리스트에 넣는 렌더러를 고르세요. 보안 정책은 보통 스크립트를 실은 태그를 차단 목록에 두고 무해한 표현 태그를 허용하므로, 마크다운 언더라인은 기본으로 작동합니다. 이 사이트의 엔진이 정확히 그 접근을 취합니다. 모두 살균하고, u를 화이트리스트에 올리고, 여기서 렌더링되는 모든 문서에 대해 호환성 질문이 사라집니다.

유일한 비(非)전략은 문법의 즉흥입니다. 언더스코어로 밑줄을 긋고, 강조 마커를 용도 바꿔 쓰고, 제목 스타일을 남용하는 것 — 모두 한 렌더러에서는 밑줄처럼 보이고 세 곳에서는 부서지는 마크업을 만듭니다. 마크다운 언더라인은 u 태그이거나 없거나입니다. 그 외的一切은 일부러 심는 호환성 버그입니다.

문서가 여러 플랫폼에 배포될 예정이라면, 가장 엄격한 환경에서 먼저 시험해 보세요. 엄격한 곳에서 통과하면 나머지에서도 통과합니다. 실험은 1분이면 충분하고, 그 1분이 출시 후의 당황을 막아 줍니다.

기술 문서를 오래 운영한다면 허용 태그 목록을 팀 문서로 남겨 두세요. 어느 렌더러가 u를 허용하고 어느 도구가 걷어내는지 기록해 두면, 새 문서를 쓰는 동료가 매번 실험을 반복하지 않아도 됩니다. 호환성은 지식이 모이는 분야입니다.

호환성 문제는 결국 문서의 수명 문제입니다. 오늘의 플랫폼은 내일 바뀌지만, 잘 쓴 소스는 남습니다. 어디서든 살아남는 표현을 우선하고, 플랫폼 의존적인 표현은 필요한 곳에만 쓰는 원칙이 문서를 오래 쓰는 비결입니다.

마지막으로 문서의 수명을 생각해 보세요. 오늘 잘 보이는 밑줄이 5년 뒤에도 그대로일지는 아무도 장담하지 못합니다. 어디서나 살아남는 표현 위주로 쓰고, 예외적인 표현은 기록을 남겨 두면 문서는 플랫폼이 바뀌어도 자기 모습을 지켜 냅니다.