본문 바로가기
C.W.K.
Stream
Lesson 06 of 08 · published

링크와 이미지

~12 min · markdown, links, images, accessibility

Level 0평문
0 XP0/64 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete

인라인, 참조, autolink

Markdown 링크에는 세 가지 스타일이 있어. 인라인 ([text](url)) 이 기본이고 짧은 문서에 잘 맞아. 참조 ([text][id] 를 쓰고 [id]: url 은 딴 데 몰아두는 방식) 는 링크가 많을 때 본문을 읽을 만하게 지켜줘. autolink (<https://example.com>) 는 맨 URL 을 그냥 감싸는 거고.

이미지는 같은 문법에 ! 만 추가

![alt text](url) 처럼 쓰면 돼. alt 텍스트는 넣어도 그만 말아도 그만인 게 아니야. 스크린 리더가 그걸 읽고, 이미지가 안 뜰 때 대신 그게 보여. alt 를 아예 비워두면 (![](url)) '이건 장식이다' 라고 못 박는 뜻이 돼.

크기 조절은 HTML 필요

CommonMark 에는 이미지 크기를 정하는 문법이 없어. 크기를 잡아야 하면 <img> 태그를 직접 쓰고 width, height, style 을 붙여. Markdown 렌더러는 대부분 inline HTML 을 그대로 통과시켜 줘.

접근성 원칙: alt 텍스트는 그 이미지가 이 맥락에서 무슨 일을 하는지 를 적는 거야. 생김새를 적는 게 아니고. 문서 맨 위 로고면 alt='Acme Corp logo' 지, 'Three blue triangles' 가 아니야.

Code

인라인 링크·markdown
[Link text](https://example.com)
[With title](https://example.com "Hover title")
참조 스타일 (본문 가독성)·markdown
Read the [CommonMark spec][cm] for details.
Also see [GFM][].

[cm]: https://commonmark.org "CommonMark"
[GFM]: https://github.github.com/gfm/
Autolink·markdown
<https://example.com>
<user@example.com>
이미지 + 크기 fallback·markdown
![Alt text](https://example.com/image.png)
![Logo](./logo.png "Optional title")

<!-- 너비 필요? HTML 로 떨어져: -->
<img src="photo.png" alt="Description" width="400">

External links

Exercise

기존 README 하나를 인라인 링크에서 참조 스타일로 바꿔봐. 본문이 사전이 아니라 문장처럼 읽히는 거 느껴봐. 어디에 어떤 스타일이 맞을지 직접 결정해.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.