Markdown문서화

링크와 이미지 기본

텍스트 링크와 이미지를 문서 안에 자연스럽게 넣는 Markdown 기본 문법을 정리한 카드입니다.

마지막 수정 2026년 3월 19일

기본 패턴

text

[링크 텍스트](https://example.com)

![대체 텍스트](https://example.com/image.png)

설명

링크는 참고 문서 연결, 이미지 파일은 시각 자료 삽입에 사용합니다.
링크 텍스트는 "여기 클릭"보다 내용이 드러나는 문구가 더 좋습니다.
이미지에는 가능한 한 대체 텍스트를 넣어야 의미가 전달됩니다.
문서가 링크 없이도 읽히되, 필요할 때 더 깊이 들어갈 수 있게 만드는 것이 좋습니다.

짧은 예제

text

[PostgreSQL SELECT 문서](https://www.postgresql.org/docs/current/tutorial-select.html)

![프로세스 상태도](./images/process-state.png)

빠른 정리

문법	의미
`[text](url)`	일반 링크
`![alt](url)`	이미지
alt text	이미지 의미 설명
의미 있는 링크 텍스트	가독성과 접근성 향상

공식 참고: Basic writing and formatting syntax

주의할 점

이미지는 보조 자료여야지 핵심 설명을 전부 대신하면 안 됩니다. 이미지가 로드되지 않아도 문서 의미가 유지되도록 텍스트 설명을 함께 두는 편이 좋습니다.