GitHub에서 파일을 바로 생성하고 편집할 때 사용할 수 있는 다양한 마크다운 태그와 강조 기술들을 소개합니다.
제목 태그 (Headers)
제목을 만들려면 텍스트 앞에 #
기호를 사용합니다. #
의 개수에 따라 제목 레벨이 결정됩니다[1].
# 제목 1 (H1)
## 제목 2 (H2)
### 제목 3 (H3)
#### 제목 4 (H4)
##### 제목 5 (H5)
###### 제목 6 (H6)
주의사항: #
과 텍스트 사이에 반드시 공백이 있어야 합니다[2][3].
텍스트 강조 기술
기본 강조 스타일
다양한 방법으로 텍스트를 강조할 수 있습니다[1][4]:
*기울임체* 또는 _기울임체_
**굵게** 또는 __굵게__
***굵은 기울임체*** 또는 ___굵은 기울임체___
~~취소선~~
밑줄 추가
마크다운에서 밑줄은 기본적으로 지원되지 않으므로 HTML 태그를 직접 사용해야 합니다[5]:
<u>밑줄 텍스트</u>
고급 강조 기능
경고 (Alerts)
GitHub에서는 중요한 정보를 강조하기 위한 경고 블록을 지원합니다[1]:
> [!NOTE]
> 유용한 정보입니다.
> [!TIP]
> 도움이 되는 조언입니다.
> [!IMPORTANT]
> 중요한 정보입니다.
> [!WARNING]
> 즉시 주의가 필요한 정보입니다.
> [!CAUTION]
> 위험이나 부정적인 결과에 대한 경고입니다.
인용문 (Blockquotes)
인용문을 만들려면 >
기호를 사용합니다[6][3]:
> 첫 번째 인용문
>> 두 번째 레벨 인용문
>>> 세 번째 레벨 인용문
목록 태그
순서 없는 목록
*
, +
, -
기호를 사용하여 순서 없는 목록을 만들 수 있습니다[6][3]:
* 첫 번째 항목
+ 두 번째 항목
- 세 번째 항목
순서 있는 목록
숫자와 점을 사용하여 순서 있는 목록을 만들 수 있습니다[6][3]:
1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목
코드 강조
인라인 코드
백틱(`)을 사용하여 인라인 코드를 강조할 수 있습니다[7][3]:
`코드 텍스트`
코드 블록
백틱 3개를 사용하여 코드 블록을 만들 수 있습니다[7][6]:
```
def hello():
print("Hello, World!")
### 구문 강조
언어 이름을 지정하여 구문 강조를 활성화할 수 있습니다[7][6]:
markdown
function hello() {
console.log("Hello, World!");
}
## 표 (Tables)
`|` 기호를 사용하여 표를 만들 수 있습니다[8]:
markdown
헤더 1 | 헤더 2 | 헤더 3 |
---|---|---|
데이터 1 | 데이터 2 | 데이터 3 |
데이터 4 | 데이터 5 | 데이터 6 |
정렬을 위해 `-` 양쪽에 `:`을 사용할 수 있습니다[8]:
markdown
왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
---|---|---|
데이터 1 | 데이터 2 | 데이터 3 |
## 링크와 이미지
### 링크 만들기
### 이미지 삽입
markdown

## 수평선
수평선을 만들려면 다음 중 하나를 사용합니다[6][9]:
markdown
“`
줄바꿈
마크다운에서 줄바꿈을 하려면 다음 방법을 사용합니다[8][3]:
- 문장 끝에 공백 두 개를 추가하고 Enter
<br>
태그 사용- 빈 줄 하나 추가
GitHub 편집기 사용법
GitHub에서 파일을 편집할 때는 다음과 같은 방법을 사용할 수 있습니다:
- 기본 편집기: 파일을 열고 연필 아이콘을 클릭하여 편집[10]
- github.dev: 드롭다운 메뉴에서 “github.dev”를 선택하여 VS Code 스타일 편집기 사용[11][10]
- GitHub Desktop: 로컬에서 편집하기 위해 GitHub Desktop 사용[10]
이러한 마크다운 태그와 강조 기술들을 활용하면 GitHub에서 더욱 읽기 쉽고 전문적인 문서를 작성할 수 있습니다.
출처
[1] 기본 쓰기 및 서식 지정 구문 – GitHub Docs https://docs.github.com/ko/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
[2] [GitHub] #3 README 파일 작성 방법 [마크다운-MarkDown] https://novlog.tistory.com/entry/GitHub-3-README-%ED%8C%8C%EC%9D%BC-%EC%9E%91%EC%84%B1-%EB%B0%A9%EB%B2%95-%EB%A7%88%ED%81%AC%EB%8B%A4%EC%9A%B4-MarkDown
[3] #35 깃(Git) – 깃허브 리드미(README) 2 : 마크다운(markdown) 문법 https://abled.tistory.com/39
[4] Markdown(마크다운) 문법 & 사용법 : 강조(emphasis) – 나아가는중 https://dlee0129.tistory.com/55
[5] 마크다운(MarkDown) 사용법 총정리 – HEROPY.DEV https://www.heropy.dev/p/B74sNE
[6] 마크다운(Markdown) 사용법 – GitHub Gist https://gist.github.com/ihoneymon/652be052a0727ad59601
[7] 코드 블록 만들기 및 강조 표시 – GitHub Docs https://docs.github.com/ko/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks
[8] Git Readme.md 작성법 / 마크다운 문법 https://velog.io/@seeseal/Git-Readme.md-%EC%9E%91%EC%84%B1%EB%B2%95-%EB%A7%88%ED%81%AC%EB%8B%A4%EC%9A%B4-%EB%AC%B8%EB%B2%95
[9] 마크다운(MarkDown) 작성 문법 총정리 – Inpa Dev – 티스토리 https://inpa.tistory.com/entry/MarkDown-%F0%9F%93%9A-%EB%A7%88%ED%81%AC%EB%8B%A4%EC%9A%B4-%EB%AC%B8%EB%B2%95-%F0%9F%92%AF-%EC%A0%95%EB%A6%AC
[10] 리포지토리에서 파일 편집 – GitHub Docs https://docs.github.com/ko/repositories/working-with-files/managing-files/editing-files
[11] github.dev 웹 기반 편집기 https://docs.github.com/ko/codespaces/the-githubdev-web-based-editor
[12] Velog 작성법 _마크다운(Markdown) https://velog.io/@lwj6079/%EB%A7%88%ED%81%AC%EB%8B%A4%EC%9A%B4Markdown-%EC%9E%91%EC%84%B1%EB%B2%95
[13] [Markdown] 마크다운 문법 – 기억보단 기록을 – GitHub Pages https://choijaegwon.github.io/githubblog/GithubBlog4/
[14] jinkyukim-me/markdown_ko: 마크다운 정리 – GitHub https://github.com/jinkyukim-me/markdown_ko
[15] [정보] Github에서 Markdown 문서 작성 팁 – JM’s NOTE – 티스토리 https://min88.tistory.com/entry/%EC%A0%95%EB%B3%B4-Github%EC%97%90%EC%84%9C-Markdown-%EB%AC%B8%EC%84%9C-%EC%9E%91%EC%84%B1-%ED%8C%81
[16] GitHub Docs에서 Markdown 및 Liquid 사용하는 방법 https://docs.github.com/ko/enterprise-cloud@latest/contributing/writing-for-github-docs/using-markdown-and-liquid-in-github-docs
[17] 마크다운(Markdown) 사용법/문법 – GitHub Gist https://gist.github.com/yunwoong7/83246af10e1831233a870c26104e4a1f
[18] Github – 마크다운(MarkDown) 문법 정리 – 개발하는만두 https://dev-youngjun.tistory.com/51
[19] 제목, 수평선(가로줄), 인용구 – Markdown 코드랩 https://codelabs-markdown.web.app/sections/02
[20] [Github 블로그] 마크다운(Markdown) 문법 총 정리 https://ansohxxn.github.io/blog/markdown/
[21] Chrome™용 마크다운 편집기 – Chrome 웹 스토어 https://chrome.google.com/webstore/detail/markdown-editor-for-chrom/dkpldbigkfcgpamifjimiejipmodkigk
[22] [github][web][1] github 웹 페이지 만들기 – 하니 – 티스토리 https://leevisual.tistory.com/617
[23] 깃허브 – 코드 충돌 후 웹 에디터에서 직접 편집하기 https://bloodstrawberry.tistory.com/967
[24] [GitHub] 깃허브GitHub 사용 방법 (1) / 파일 업로드, 수정, 삭제 등 https://hwangseoyoung.tistory.com/115
[25] github.dev로 간단하게 코드 살펴보기 https://80000coding.oopy.io/97dd08bd-e658-4302-9c77-e4ab2d660047
[26] 깃허브 기초부터 깃과 차이점, 사용법, 프로필 꾸미기까지! https://spartacodingclub.kr/blog/github_guide
[27] marktext/marktext: A simple and elegant markdown editor … – GitHub https://github.com/marktext/marktext
[28] GitHub 웹 편집기를 사용하여 웹 브라우저에서 여러 파일 편집 https://docs.aws.amazon.com/ko_kr/eks/latest/userguide/edit-web.html
[29] PowerStream3604/Toast-markdown-editor – GitHub https://github.com/PowerStream3604/Toast-markdown-editor
[30] MarkDown을 편하게 작성하기 위한 도구들 https://wooncloud.tistory.com/72
[31] github.dev (Web-IDE) – 머가필요해 https://www.whatwant.com/entry/githubdev
[32] GitHub Pages 빠른 시작 https://docs.github.com/ko/pages/quickstart
[33] Jekyll을 사용하여 GitHub 페이지 사이트에 대한 Markdown 프로세서 … https://docs.github.com/ko/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll
[34] GitHub.dev https://github.dev
답글 남기기