∧ ¬ → ∨ ⊢ ∴
2026 · 정보과학 · 인공지능 기초

신성여고 정보과학 수업 자료실

수업에서 쓰는 자료와 실습 파일을 여기서 받아가세요.

수업 자료
P₁ · 자료

1단원 자료

자료 열기 ↗ 논리 라이어 게임 ↓
⊢ 부록 · GITHUB 사용법
▸ GitHub README.md 작성법 가이드 학생용 참고 자료

이 문서는 GitHub 저장소(repository)의 README.md 파일을 어떻게 작성하는지 안내하는 가이드입니다.


1. README.md란?

README.md는 GitHub 저장소에 접속했을 때 가장 먼저 보이는 문서입니다. 프로젝트를 방문한 사람에게 "이 프로젝트가 무엇인지, 어떻게 사용하는지"를 설명하는 얼굴이자 설명서 역할을 합니다.

  • 파일 이름은 반드시 README.md (대문자 권장)
  • .md는 마크다운(Markdown) 문법으로 작성된 파일이라는 뜻
  • 저장소 루트(최상위) 폴더에 위치해야 GitHub이 자동으로 화면에 보여줌

2. 왜 잘 써야 할까?

좋은 README 부실한 README
프로젝트 이해가 빠름 무엇을 하는 프로젝트인지 모름
설치·실행이 쉬움 실행 방법을 못 찾아 포기
협업자가 기여하기 쉬움 기여 방법을 몰라 참여 못 함
포트폴리오로서 신뢰감을 줌 완성도가 낮아 보임

3. 마크다운(Markdown) 기초 문법

README는 마크다운 문법으로 작성합니다. 핵심 문법만 익히면 충분합니다.

마크다운 기초 문법 보기 (클릭)
# 제목
**굵게**  *기울임*  ~~취소선~~

- 목록
1. 순서 목록

`코드`
```python
print("코드 블록")
```

[링크](https://example.com)
![이미지](이미지주소.png)
> 인용문