Strikethrough, autolink, inline 참조

매 PR 마다 등장하는 GFM 확장 셋

Strikethrough

틸드 두 개로 감싸: ~~deprecated~~. GFM 에서 single tilde 는 아무것도 안 함. 체크리스트의 제거된 단계나 문서의 deprecated 값 표시할 때 정중한 방법 — 원본 여전히 읽히되 시각 신호는 명확.

Raw URL autolink

CommonMark 에선 raw URL 을 angle bracket 으로 감싸야 해 — <https://example.com> — 링크가 돼. GFM 은 일반 본문의 http://, https://, ftp://, www. URL 을 자동 감지 해서 링크로 만들어. 문법 필요 없음.

GitHub 전용 참조

github.com 에서 GFM 은 autolink 를 더 확장: @username = 사용자 mention, @org/team = 팀 mention, #123 = issue/PR 123 링크, 7 자 이상 SHA = 커밋 링크. 이건 휴대 안 돼 — GitHub 외부에선 직접 긴 형태 써야 렌더링.

이메일 autolink 함정: GFM 은 raw 이메일 (name@example.com) 도 자동 링크. README 에 literal 이메일 있는데 링크 안 만들고 싶으면 백틱으로 감싸 (`name@example.com`) 또는 HTML wrap (<span>name@example.com</span>).

Code

Strikethrough·markdown

~~deprecated~~ → use the new API
~~50% off~~ → 70% off this week

Autolink (GFM 에선 문법 필요 없음)·markdown

Visit https://example.com or www.example.com.
Reach me at me@example.com.

# CommonMark fallback (어디서나 작동):
Visit <https://example.com>.
Reach me at <me@example.com>.

GitHub 참조 (github.com 에서만 live)·markdown

Thanks @cwk for catching this in #142.
Fix lands in 9c2fc22.
Review from @neobundy/maintainers.

Exercise

옛 동작에 strikethrough 와 새 동작을 나란히 두는 작은 changelog 항목 써봐. 그 다음 같은 변경을 GitHub #123 형태 issue 번호와 함께 한 문장으로 써. 로컬 (#123 이 literal 텍스트) 과 테스트 GitHub gist (링크) 에서 렌더링하고 어느 형태가 어디 적합한지 봐.

Strikethrough, autolink, inline 참조

매 PR 마다 등장하는 GFM 확장 셋

Strikethrough

Raw URL autolink

GitHub 전용 참조

Code

External links

Exercise

Progress

댓글 0