[ git & github ] Git Hub README.md 작성하기( feat. 마크다운 Language)

Git

호IT 2021. 2. 18. 05:45

이 포스팅은 구름 에듀 강좌 나동빈 선생님 강의 "Git으로 시작하는 협업 및 오픈소스 프로젝트" 를 기반으로 작성되었습니다.

구름EDU - 모두를 위한 맞춤형 IT교육

구름EDU는 모두를 위한 맞춤형 IT교육 플랫폼입니다. 개인/학교/기업 및 기관 별 최적화된 IT교육 솔루션을 경험해보세요. 기초부터 실무 프로그래밍 교육, 전국 초중고/대학교 온라인 강의, 기업/

edu.goorm.io

- README.md

README파일은 저장소의 이해를 돕기 위한 파일입니다.

간단하게 깃허브에서 파일을. 추가할 수도 있습니다.

Add a README 버튼을 클릭하면 Edit new file에 작성된 파일을 Preview에서 바로 확인할 수도 있습니다.

입력 후 일단 "Commit new file" 을 클릭하여 만들어 보겠습니다.

그럼 README.md 파일을 확인할 수 있습니다.

자신의 로컬 저장소에도 같은 내용을 담고 싶다면 git pull 명령어를 통해 받아주면 됩니다.

내 로컬 디렉토리에도 README.md 파일이 생긴 것을 확인할 수 있습니다.

로컬에서도 파일 설정/수정이 가능하지만,

깃 허브에서 프리뷰를 통해 바로 보면서 설정 할 수 있기 때문에 github를 추천한다고 합니다.

README파일은 마크다운의 확장자인 .md를 가진다는 특징이 있습니다.

이제 README.md 파일을 작성해보겠습니다.

큰 글씨는 # 으로 입력하면 됩니다.

# 이 한 개 있는 것이 가장 큰 글씨, 많아질수록 작아집니다.

# 은 5개 까지 사용 가능하다고 합니다.

소스코드를 넣고 싶다면, ESC 키 밑의 백틱문자를 활용하면됩니다.

백틱문자 세개에, 사용하는 언어를 적으면 됩니다.

위 두가지를 사용해 작성하겠습니다.

링크를 넣고 싶다면 다음과 같이 작성하면 됩니다.

[ ] 사이에는 표시될 내용이 들어갑니다.

( ) 사이에는 링크로 들어갈 url 이 들어갑니다.

프리뷰를 이용해서 보면, 위와 같이 하이퍼링크 텍스트가 생성됩니다.

* 은 순서 없는 목록을 나타낸다.

* 뒤에는 공백이 있어야합니다.

인용구문은 다음과 같이 > 를 이용해 작성합니다.

프리뷰를 보면 아래와 같이 출력됩니다.

테이블은 다음과 같이 작성합니다.

강조는 다음과 같이 할 수 있습니다.

여기까지 실습을 하고 저장을하고 전체적으로 보겠습니다.

깔끔하게 잘 나오는 것을 알 수 있습니다.

오픈소스 프로젝트의 가장 기본적인 "README"파일을 쉽게 이해할 수 있게 잘 써야

다른 사람들이 자신의 프로젝트가 무엇을 의미하는지 잘 파악할 수 있습니다.