- README.md 이란?
- README 문법
-
- 제목 (header)
- 줄바꿈 (line break)
- 수평선 (horizontal rule)
- 글자 강조 (emphasis)
- 목록 (list)
- 인용문 (block quote)
- 표 (table)
- 코드 블록 (code block)
- 내부문서 이동
- 외부링크 이동
# README.md 이란?
- GitHub 등 코드 호스팅 서비스에서 프로젝트 정보가 담긴 파일
- 프로젝트 개요, 설치 방법, 사용법, 기여 방법, 라이센스 정보 등 프로젝트의 정보를 문서화하여 다른 개발자나 사용자에게 프로젝트에 대해 알려줄 수 있다
- ReadMe.md 의 .md 확장자는 MarkDown의 약자이며, ReadMe 파일은 마크다운 문법을 사용한다
# README 문법
# 제목 (header)
- 1단계(큰)에서 6단계(작은)까지 표현할 수 있으며 # (Crosshatch)으로 구분한다
- # 이 적을수록 큰 단계(글자)로 표현된다
# 제목 1단계
## 제목 2단계
### 제목 3단계
#### 제목 4단계
##### 제목 5단계
###### 제목 6단계
# 줄바꿈 (line break)
- 엔터 한번은 줄바꿈이 적용되지 않는다
- 엔터 전 행의 띄어쓰기 두번 혹은 두번 엔터해야 줄바꿈이 인식된다
- 혹은 줄바꿈 태그<br/> 를 사용해도 된다
띄어쓰기 한번
띄어쓰기 한번
***
띄어쓰기 두번
띄어쓰기 두번
***
엔터 한번
엔터 한번
***
엔터 두번
***
엔터 두번
***
라인 1<br>라인 2
# 수평선 (horizontal rule)
- - (Hyphen) 혹은 * (Asterisk) 기호를 3번 이상 작성
수평선
---
수평선
***
# 글자 강조 (emphasis)
- 굵게 : * (Asterisk) 기호 혹은 _ (Underscor) 기호 두번 양쪽 작성
- 이텔릭 : * (Asterisk) 기호 혹은 _ (Underscor) 기호 한번 양쪽 작성
- 굵기 + 이텔릭 : * (Asterisk) 기호 혹은 _ (Underscor) 기호 세번 양쪽 작성
- 취소선 : ~ (Tilde) 기호 두번 양쪽 작성
- 밑즐 : 태그 <u> 이용
- 색강조 : ` (Grave) 기호 한번 양쪽 작성
**굵은 글씨** or __굵은 글씨__
*이텔릭* or _이탤릭_
***굵고 이텔릭*** or ___굵고 이텔릭___
~~취소선~~
<u>밑줄</u>
`색강조`
# 목록 (list)
- 순서가 필요한 리스트 : 1. (자동으로 인덱싱 된다)
- 순서가 필요하지 않는 리스트 : * (Asterisk), +(Plus Sign), - (Hyphen)
1. 순서가 필요한 목록
1. 순서가 필요한 목록
1. 순서가 필요한 목록
1. 순서가 필요한 목록
1. 순서가 필요한 목록
- 순서가 필요하지 않은 목록
- 순서가 필요하지 않은 목록
- 순서가 필요하지 않은 목록
- 순서가 필요하지 않은 목록
# 인용문 (block quote)
- > (Greater than) 기호를 사용하며, 반복 사용하면 중첩된다
> 인용문장
>> 중첩된 인용문
>>> 중첩된 인용문 2
# 표 (table)
- 테이블 헤더와 바디는 - (Hyphen)으로 구분한다.
- : (Colons) 기호로 내부 텍스트를 정렬한다 ( :-- 왼쪽 정렬, :--: 가운데 정렬, --: 오른쪽 정렬)
- 열은 | (Vertical Bar) 기호로 구분, 행은 줄바꿈으로 구분한다
| th---1 | th2--- | th---3 |
| :-- | :--: | --: |
| td | td | td |
| td | td | td |
| th---1 | th2--- | th---3 |
| - | -- | ---- |
| td | td | td |
| td | td | td |
# 코드 블록 (code block)
- ` (Grave) 기호를 세번 작성한다
```
<div>
<p>Hello, J!</p>
</div>
```
# 내부문서 이동
- 클릭하면 해당 페이지의 원하는 위치로 화면이 이동할 수 있다 (스크롤 이동)
- [링크](#이동위치) : [보여지는 텍스트]를 클릭하면 (#마크다운-문법)의 위치로 이동한다
[보여지는 텍스트](#마크다운-문법)
...
# 마크다운 문법
- 작성 방법
- 띄어쓰기는 - (Hyphen) 기호로 연결한다
- 영어는 모두 소문자로 작성한다
- 소괄호, 이모지, 특수문자는 모두 제거한다
- 이동할 위치는 # (Crosshatch) 기호로 제목으로 구분되어 있어야 한다
- ex : 마크다운 문법(Markdown Grammar) ▷ [링크](#마크다운-문법markdown-grammar)
# 외부링크 이동
- text 에 링크 걸기 : [링크](url)
- url 노출하며 링크 걸기 : <url>
[Naver Move](https://www.naver.com/)
<https://www.naver.com/>
'Web 개발 > Etc' 카테고리의 다른 글
Placehold.co - 임시 이미지 온라인 서비스 (0) | 2025.02.22 |
---|