마크다운 완벽가이드 3편 - 고급 활용
마크다운 완벽가이드 3편 - 고급 활용
요약
이 글의 핵심 3가지
- HTML 활용: 마크다운 한계를 HTML로 극복하는 방법
- 실전 테크닉: 이미지 크기 조정, 색상, 주석, Admonitions 등 고급 기능
- 고급 예제: GitHub README, Astro 블로그, 옵시디언 노트 실전 활용법
읽는 시간: 20분 | 난이도: 중급
출처
이 글은 다음 자료를 바탕으로 작성되었습니다.
- Markdown Guide - Hacks - 마크다운 활용 팁과 트릭
- Markdown Guide - Cheat Sheet - 전체 문법 치트시트
대상 독자: 기본/확장 문법을 익히고 마크다운을 더 자유롭게 활용하고 싶은 분
선수 학습:
마크다운 고급 활용이란?
기본 문법과 확장 문법만으로도 대부분의 작업은 가능합니다.
하지만 때로는 마크다운만으로는 부족한 순간이 있습니다.
- 이미지 크기를 조절하고 싶을 때
- 텍스트 색상을 바꾸고 싶을 때
- 중앙 정렬을 하고 싶을 때
- 주석을 추가하고 싶을 때
- 경고 박스를 만들고 싶을 때
이런 상황에서 HTML과 CSS를 활용하면 마크다운의 한계를 극복할 수 있습니다.
주의: 이 글의 테크닉들은 모든 마크다운 에디터에서 작동하지 않습니다.
Astro, 옵시디언, GitHub 등에서 먼저 테스트하세요.
HTML과 마크다운 혼합
대부분의 마크다운 프로세서는 마크다운 안에 HTML을 섞어 쓸 수 있습니다.
기본 규칙
이것은 **마크다운**입니다.
<p style="color: blue;">이것은 HTML입니다.</p>
다시 마크다운으로 돌아왔습니다.결과:
이것은 마크다운입니다.
이것은 HTML입니다.
다시 마크다운으로 돌아왔습니다.
주의사항
- 블록 레벨 요소 앞뒤로 빈 줄 추가
올바른 방법:
<div>HTML 블록</div>
다음 단락- HTML 태그 안에서 마크다운 사용 불가
<p>**이것은 굵게 되지 않습니다**</p>- 인라인 요소는 마크다운과 섞어 쓸 수 있음
이것은 <em>이탤릭</em>이고 이것은 **굵은** 텍스트입니다.이미지 고급 활용
마크다운 기본 이미지 문법()은 크기 조절이 안 됩니다.
이미지 크기 조정
HTML <img> 태그를 사용합니다.
<img src="./image.jpg" width="300" height="200">속성:
| 속성 | 설명 | 예시 |
|---|---|---|
width | 가로 크기 (픽셀) | width="300" |
height | 세로 크기 (픽셀) | height="200" |
alt | 대체 텍스트 | alt="이미지 설명" |
비율 유지:
가로만 지정하면 비율이 자동으로 유지됩니다.
<img src="./image.jpg" width="50%">이미지 캡션
방법 1: HTML <figure> (권장)
<figure> <img src="./trail.jpg" alt="Albuquerque, New Mexico"> <figcaption>뉴멕시코 앨버커키 외곽의 트레일</figcaption></figure>방법 2: 마크다운 + 이탤릭
_뉴멕시코 앨버커키 외곽의 트레일_이미지 정렬
CSS를 사용합니다.
중앙 정렬:
<p style="text-align: center;"> <img src="./image.jpg" width="300"></p>왼쪽/오른쪽 정렬:
<img src="./image.jpg" width="300" style="float: right; margin: 10px;">텍스트 스타일링
텍스트 색상
CSS style 속성을 사용합니다.
<p style="color: red;">빨간색 텍스트</p><p style="color: #0066cc;">파란색 텍스트 (16진수)</p>결과:
빨간색 텍스트
파란색 텍스트 (16진수)
색상 표현 방법:
| 방법 | 예시 |
|---|---|
| 색상명 | red, blue, green |
| 16진수 | #FF0000, #0066CC |
| RGB | rgb(255, 0, 0) |
밑줄
<ins> 또는 <u> 태그를 사용합니다.
<ins>밑줄 텍스트</ins>결과: 밑줄 텍스트
중앙 정렬
CSS text-align 속성을 사용합니다.
<p style="text-align: center;">중앙 정렬된 텍스트</p>결과:
중앙 정렬된 텍스트
주의: <center> 태그는 deprecated되었습니다. CSS를 사용하세요.
들여쓰기
HTML 비중단 공백( )을 사용합니다.
들여쓰기된 단락입니다.결과:
들여쓰기된 단락입니다.
팁: 4개 = 약 4칸 들여쓰기
주석과 숨김 텍스트
주석 추가
렌더링 결과에 나타나지 않는 숨겨진 텍스트입니다.
여기는 보이는 단락입니다.
[이것은 주석입니다. 렌더링 결과에 나타나지 않습니다.]: #
다시 보이는 단락입니다.규칙:
- 주석 전후로 빈 줄 필요
[주석 내용]: #형식
용도:
- 메모 작성
- 임시 비활성화
- 협업 시 노트
Admonitions (주의사항 박스)
경고, 노트, 팁 등을 강조하기 위한 박스입니다.
기본 문법
인용구 + 이모지 + 굵은 제목을 조합합니다.
> ⚠️ **Warning:** 빨간 버튼을 누르지 마세요.
> 📝 **Note:** 일출은 아름답습니다.
> 💡 **Tip:** 작은 것에 감사하세요.결과:
⚠️ Warning: 빨간 버튼을 누르지 마세요.
📝 Note: 일출은 아름답습니다.
💡 Tip: 작은 것에 감사하세요.
주요 유형
| 유형 | 이모지 | 용도 |
|---|---|---|
| Warning | ⚠️ | 위험 경고 |
| Caution | 🚨 | 주의사항 |
| Note | 📝 | 정보성 노트 |
| Tip | 💡 | 유용한 팁 |
| Info | ℹ️ | 일반 정보 |
| Success | ✅ | 성공 메시지 |
| Error | ❌ | 에러 메시지 |
여러 줄 Admonition
> 💡 **Tip: 마크다운 학습법**>> 1. 기본 문법부터 시작> 2. 실제로 써보면서 익히기> 3. 확장 문법 학습>> 매일 조금씩 연습하면 금방 익숙해집니다!결과:
💡 Tip: 마크다운 학습법
- 기본 문법부터 시작
- 실제로 써보면서 익히기
- 확장 문법 학습
매일 조금씩 연습하면 금방 익숙해집니다!
기호와 특수문자
방법 1: 직접 복사-붙여넣기
© ® ™ € ← ↑ → ↓ ° π결과: © ® ™ € ← ↑ → ↓ ° π
방법 2: HTML 엔티티
© (저작권)® (등록 상표)™ (상표)€ (유로)← (왼쪽 화살표)→ (오른쪽 화살표)° (도)π (파이)결과:
© ® ™ € ← → ° π
자주 쓰는 HTML 엔티티:
| 기호 | 엔티티 | 설명 |
|---|---|---|
| © | © | 저작권 |
| ® | ® | 등록 상표 |
| ™ | ™ | 상표 |
| € | € | 유로 |
| ° | ° | 도 (각도/온도) |
| π | π | 파이 |
| ✓ | ✓ | 체크 |
| ✗ | ✗ | X |
비디오 임베딩
방법 1: HTML 임베드 (권장)
유튜브, 비메오 등에서 제공하는 임베드 코드를 사용합니다.
<iframe width="560" height="315" src="https://www.youtube.com/embed/VIDEO-ID" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>방법 2: 이미지 + 링크
HTML을 지원하지 않는 경우 사용합니다.
[](https://www.youtube.com/watch?v=VIDEO-ID)작동 방식:
- 유튜브 썸네일 이미지를 표시
- 클릭하면 유튜브 영상으로 이동
테이블 고급 활용
셀 내 개행
<br> 태그를 사용합니다.
| 항목 | 설명 || -------- | ---------------------------------- || 마크다운 | 첫 번째 단락.<br><br>두 번째 단락. |결과:
| 항목 | 설명 |
|---|---|
| 마크다운 | 첫 번째 단락. 두 번째 단락. |
셀 내 목록
HTML 목록 태그를 사용합니다.
| 기능 | 목록 || --------- | ------------------------------------------------------- || 확장 문법 | <ul><li>테이블</li><li>코드 블록</li><li>각주</li></ul> |결과:
| 기능 | 목록 |
|---|---|
| 확장 문법 |
|
목차 만들기
자동 목차 (일부 에디터)
옵시디언, MkDocs 등은 자동 목차를 지원합니다.
[[TOC]]또는
[TOC]수동 목차
제목 ID를 활용해 링크를 만듭니다.
## 목차
- [기본 문법](#기본-문법)- [확장 문법](#확장-문법)- [고급 활용](#고급-활용)
---
## 기본 문법
내용...
## 확장 문법
내용...
## 고급 활용
내용...제목 ID 규칙:
- 영문은 소문자로 변환
- 공백은 하이픈(
-)으로 변환 - 특수문자는 제거
예: ## 마크다운 기본 문법 → #마크다운-기본-문법
빠른 참고 자료
마크다운 문법을 빠르게 찾아보려면 별도로 준비한 치트시트를 확인하세요:
📋 마크다운 치트시트 - 전체 문법을 한눈에 볼 수 있는 빠른 참고 자료
기본 문법, 확장 문법, HTML 활용까지 테이블로 정리되어 있어 작업 중 빠르게 찾아볼 수 있습니다.
실전 예제
GitHub README 고급 버전
<p align="center"> <img src="./logo.png" width="200"></p>
<h1 align="center">프로젝트 이름</h1>
<p align="center"> <img src="https://img.shields.io/badge/version-1.0.0-blue"> <img src="https://img.shields.io/badge/license-MIT-green"></p>
---
## 📋 목차
- [소개](#소개)- [설치](#설치)- [사용법](#사용법)
---
## 소개
> 💡 **Tip:** 이 프로젝트는 초보자에게 적합합니다.
프로젝트 설명...
---
## 설치
\`\`\`bashnpm install project-name\`\`\`
> ⚠️ **Warning:** Node.js 18 이상이 필요합니다.
---
## 라이선스
<p style="color: #666;"> © 2026 Project Name. All rights reserved.</p>Astro 블로그 포스트 고급
---title: "고급 마크다운 활용법"published: 2025-12-31---
<p style="text-align: center; color: #666; font-size: 0.9em;"> 마지막 업데이트: 2025년 12월 31일</p>
---
## 주요 내용
<div style="background: #f5f5f5; padding: 20px; border-left: 4px solid #0066cc;">
**이 글에서 배울 내용:**
- HTML과 마크다운 혼합- 이미지 고급 활용- Admonitions 만들기
</div>
---
## 예제 코드
\`\`\`typescript// 타입스크립트 예제interface Config {theme: 'light' | 'dark';lang: string;}\`\`\`
[주석: 이 코드는 나중에 업데이트 예정]: #
---
## 참고
> 📝 **Note:** 자세한 내용은 [공식 문서](#)를 참고하세요.
<p style="text-align: center; margin-top: 40px;"> ⬆️ <a href="#top">맨 위로 돌아가기</a></p>옵시디언 노트 고급
# 마크다운 마스터 노트
<div style="background: #ffe6e6; padding: 15px; border-radius: 5px;">
⚠️ **중요 알림**
이 노트는 마크다운 고급 활용법을 정리한 문서입니다.
</div>
---
## 학습 체크리스트
- [x] 기본 문법 마스터- [x] 확장 문법 익히기- [x] HTML 혼합 사용- [ ] 실전 프로젝트 적용
---
## 핵심 개념
마크다운 고급 활용: HTML과 CSS를 결합하여 마크다운의 한계를 극복하는 기법
---
## 유용한 기호
자주 쓰는 기호: © ® ™ → ✓ ✗
수식: E = mc<sup>2</sup>, H<sub>2</sub>O
---
## 관련 노트
- [[마크다운 기본 문법]]- [[Astro 블로그 설정]]- [[옵시디언 플러그인]]
#마크다운 #고급활용 #실전호환성 주의사항
다음 기능은 에디터에 따라 지원 여부가 다릅니다.
| 기능 | Astro | GitHub | 옵시디언 | VS Code |
|---|---|---|---|---|
| HTML 태그 | ✅ | ✅ | ✅ | ✅ |
| CSS 스타일 | ✅ | ❌ | ✅ | ⚠️ |
<iframe> | ✅ | ❌ | ⚠️ | ❌ |
주석 []: # | ✅ | ✅ | ✅ | ✅ |
| Admonitions | ⚠️ | ⚠️ | ✅ | ⚠️ |
| 자동 목차 | ⚠️ | ❌ | ✅ | ⚠️ |
✅ 완전 지원 | ⚠️ 부분 지원 | ❌ 미지원
권장사항:
- 사용 전 에디터에서 테스트
- 중요한 콘텐츠는 순수 마크다운 사용
- HTML은 꼭 필요할 때만 사용
- CSS는 인라인 스타일만 사용
참고 자료
공식 문서
- Markdown Guide - Hacks - 마크다운 활용 팁
- Markdown Guide - Cheat Sheet - 완전 치트시트
- MDN - HTML 태그 레퍼런스 - HTML 태그 문서
도구
- Markdown Tables Generator - 테이블 생성 도구
- HTML Color Codes - 색상 코드 선택기
- HTML Entity Reference - HTML 엔티티 목록
추가 학습
- MDN Web Docs - HTML/CSS 학습
- Can I Use - 브라우저 호환성 확인
- Emmet Documentation - HTML 빠른 작성
마치며
마크다운 완벽가이드 시리즈를 모두 마쳤습니다!
배운 내용 정리
1편 - 기초:
- 마크다운이란 무엇인가
- 11가지 기본 문법
- Astro와 옵시디언 활용
2편 - 확장 문법:
- 테이블, 코드 블록, 체크리스트
- 각주, 이모지, 취소선
- 확장 문법 호환성
3편 - 고급 활용:
- HTML과 마크다운 혼합
- 이미지/텍스트 고급 스타일링
- Admonitions, 주석, 비디오
- 실전 예제 (README, 블로그, 옵시디언)
다음 단계
이제 마크다운을 자유자재로 다룰 수 있습니다!
- Astro 블로그: 포스팅 시작하기
- 옵시디언: 나만의 지식 노트 작성
- GitHub: README와 문서 작성
- 실전 프로젝트: 배운 내용 적용
💡 Tip: 마크다운은 매일 조금씩 써보는 것이 가장 빠른 학습법입니다.
공유
이 글이 도움이 되었다면 다른 사람과 공유해주세요!