마크다운 제거 도구가 버리는 것, 그리고 그것을 지키는 법

“마크다운을 걷어낸다”는 말은 한 가지 작업처럼 들립니다. 실제로는 작은 결정들의 연속이고, 변환 기는 인정하든 하지 않든 그 하나하나를 여러분 대신 내립니다.

대개 잘못 결정되는 것들이 여기 있습니다.

목록 번호

가장 파장이 큽니다. 흔히 쓰이는 라이브러리는 목록을 서식 구성물로 보고 평탄화하며, 그 과정에서 글머리 기호와 함께 1. 2. 3.을 없앱니다.

글머리 목록이라면 그럴 만하다고 볼 수도 있습니다. 번호 목록에서는 의미를 파괴합니다. 번호는 무 언가를 가리키고 있었습니다. 번호가 매겨진 설문에 대한 답, 순서가 있는 단계, 순위가 매겨진 항목 — 모두가 순서 없는 더미가 됩니다.

여기서는 번호를 지킵니다. 7에서 시작하는 목록도, 다른 목록 안에 중첩된 번호 목록도 포함해서요.

링크 뒤의 주소

[문서](https://example.com/guide)에는 두 가지 정보가 있습니다. 일반 텍스트에는 두 번째를 둘 자리가 없으니, 변환기는 그것을 적어 내거나 버리거나 해야 합니다.

버리는 쪽은 조용하고 흔합니다. 읽는 사람은 “문서”만 받고 거기에 닿을 방법을 잃습니다. 여기서의 기본값은 둘 다 적습니다 — 문서 (https://example.com/guide) — 링크를 따라갈 수 없는 독자는 무언 가를 잃은 것이기 때문입니다. 링크가 중요하지 않다는 것을 알 때를 위해 글자만, 주소만도 준비되어 있습니다.

코드 블록의 언어

```java로 표시된 블록은 사실 하나를 담고 있습니다. 이것은 자바다, 라는 사실입니다. 표 시를 걷어내면 그 사실도 함께 사라지고, 무엇이든 될 수 있는 설명 없는 기호 덩어리만 남습니다.

언어는 이름표로 나갑니다 — [java] — 읽는 사람이 알 수 있도록요. 원한다면 끄거나, 원래 표시 그 대로 둘 수도 있습니다.

이미지의 대체 텍스트

이미지는 이미지로 살아남을 수 없습니다. 하지만 그 대체 텍스트는 누군가가 그것을 설명하려고 쓴 문장이고, 문서 안에서 그 내용을 설명하는 유일한 것인 경우가 많습니다. 이미지를 버리고 설명을 남 기는 편이 대개 둘 다 버리는 것보다 낫습니다.

각주, 인용, 구분선, 프런트매터

각각은 제거 도구가 소리 없이 없앨 수 있는 내용입니다. 여기서는 각각이 기본으로 유지되고 개별적 으로 끌 수 있습니다.

왜 무손실이 옳은 기본값인가

이 대부분을 정리해 주는 시험은 이렇습니다. 입력을 본 적 없는 독자가 출력만 읽고도 거기 적혀 있던 모든 것을 이해할 수 있는가?

답이 아니라면, 변환기는 묻지도 않고 독자를 대신해 정보를 버린 것입니다. 여러분이 직접 지워야 할 무언가를 남기는 변환기는 십 초 동안 성가십니다. 필요했던 것을 지우는 변환기는, 그것이 중요해질 때까지 알아채지 못할 수도 있는 문제입니다.

그래서 기본값은 모든 것을 지키고, 없애는 일은 전부 여러분이 고르는 스위치입니다. 사전 설정 하나 — 보고서와 표 — 만은 그 규칙을 일부러 깨고 코드 블록과 이미지를 걷어냅니다. 떠도는 조각이 잡음이 되는 보고서에 비교표를 올리기 위해 존재하기 때문입니다. 그것은 예외이고, 그렇다고 밝히고 있으며, 기본 사전 설정은 아무것도 걷어내지 않습니다.

정말로 답이 없는 것들

어떤 결정에는 옳은 기본값이 없고 맥락만 있습니다.

• 제목으로 만들 방법이 아무것도 없을 때 제목은 어떤 모습인가? 그대로, 대문자, 또는 # 유지.
• 표가 없을 때 표는 어떤 모습인가? 정렬된 열, 탭, 또는 이름과 값.
• 작업 목록은 어떤 모습인가? [ ], ☐, 또는 아무것도 없이.

사전 설정이 존재하는 이유가 이것입니다. 하나를 골라 보편적이라고 부르는 대신, 각 사전 설정은 특 정 목적지 — 메일 프로그램, 스프레드시트, 채팅 창, 문서 페이지, 웹 양식 — 에 대해 이 모든 질문에 답하고, 견본까지 보여 줍니다. 답을 믿기 전에 직접 확인할 수 있도록요.