본문 바로가기

GitHub README 생성기

브라우저 처리

프로젝트 이름, 주소, 소개·기능·명령 몇 줄로 소개, 주요 기능, 설치, 사용법, 라이선스 절을 갖춘 GitHub README 초안을 만듭니다. 명령어는 자동으로 코드 블록에 넣습니다.

사용 전 확인
  • 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
도구 실행입력 후 결과 확인
GitHub README 생성기 샘플 실행

새 저장소를 만들면 README부터 써야 하지만 빈 화면에서 시작하기는 막막합니다. 이 생성기는 프로젝트 이름과 주소, 그리고 생각나는 대로 적은 몇 줄을 받아 GitHub에서 흔히 쓰는 구성의 README 초안을 만들어 줍니다.

브라우저 처리
샘플 결과
# ToolBada

브라우저에서 바로 쓰는 무료 도구 모음

- 링크: https://toolbada.com

## 주요 기능

- 설치 없이 실행
- 파일을 서버로 보내지 않음

## 설치

```bash
npm install
```

## 사용법

```bash
npm run build
```

## 라이선스

MIT
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

GitHub README 생성기 사용 가이드

새 저장소를 만들면 README부터 써야 하지만 빈 화면에서 시작하기는 막막합니다. 이 생성기는 프로젝트 이름과 주소, 그리고 생각나는 대로 적은 몇 줄을 받아 GitHub에서 흔히 쓰는 구성의 README 초안을 만들어 줍니다.

'세부 내용'의 첫 줄은 한 줄 소개가 되고, 나머지 일반 줄은 주요 기능 목록이 됩니다. npm, pip, git, docker 같은 명령으로 시작하는 줄은 명령어로 알아보고, install·clone이 든 명령은 '설치', 나머지는 '사용법' 코드 블록에 넣습니다. 'license: MIT'처럼 적으면 라이선스 절에 들어갑니다.

비어 있는 절에는 '<!-- 설치 명령을 적으세요 -->' 같은 안내 주석이 남아 무엇을 채워야 할지 보입니다. 한국어 페이지에서는 절 제목도 한국어로 만듭니다.

사용 방법

  1. '프로젝트 이름'과 '저장소·홈페이지 주소'를 적습니다.
  2. '한 줄 소개, 기능, 설치·실행 명령 (한 줄에 하나)' 칸에 소개 문장, '- 기능', 명령어, 'license: MIT'를 한 줄씩 적습니다.
  3. '실행'을 누른 뒤 결과를 '다운로드'해 저장소의 README.md로 저장하고 안내 주석이 남은 곳을 채웁니다.

예시: 소개·기능·명령이 섞인 입력

입력
프로젝트 이름: ToolBada
저장소·홈페이지 주소: https://toolbada.com
세부 내용:
브라우저에서 바로 쓰는 무료 도구 모음
- 설치 없이 실행
- 파일을 서버로 보내지 않음
npm install
npm run build
license: MIT
결과
# ToolBada

브라우저에서 바로 쓰는 무료 도구 모음

- 링크: https://toolbada.com

## 주요 기능

- 설치 없이 실행
- 파일을 서버로 보내지 않음

## 설치

```bash
npm install
```

## 사용법

```bash
npm run build
```

## 라이선스

MIT

npm install은 설치, npm run build는 사용법 코드 블록으로 나뉘었습니다.

이럴 때 쓰면 좋아요

  • 새 오픈소스 저장소의 README 뼈대를 빠르게 만들 때
  • 사내 프로젝트 README의 절 구성을 통일할 때
  • README가 없는 오래된 저장소에 기본 문서를 붙일 때
  • 해커톤 결과물의 소개 문서를 몇 분 안에 정리할 때

문제가 생겼을 때

명령어가 기능 목록에 들어감

npm, pip, git, docker, make 같은 명령으로 시작해야 명령어로 알아봅니다. './run.sh'처럼 다른 형태라면 결과에서 사용법 코드 블록으로 옮기세요.

한 줄 소개가 기능으로 들어감

첫 번째 일반 줄이 소개가 됩니다. 소개 문장을 '세부 내용' 맨 위에 적으세요. '- '로 시작하는 줄도 일반 줄로 봅니다.

활용 팁

  • README 맨 위 배지(빌드 상태, 버전)는 README 배지 정리기로 정돈한 뒤 제목 아래에 붙이면 좋습니다.
  • 초안을 채운 뒤 GitHub README 품질 검사기로 설치·사용법·라이선스 절이 빠지지 않았는지 확인하세요.

자주 묻는 질문

영어 README도 만들 수 있나요?

절 제목은 페이지 언어를 따릅니다. 영문 README가 필요하면 영문 페이지에서 만들거나, 결과의 절 제목을 Features, Installation처럼 바꾸세요.

스크린샷이나 배지도 넣어 주나요?

아니요. 글로 된 절만 만듭니다. 이미지는 ![설명](경로)로 직접 넣고, 배지는 README 배지 정리기를 쓰세요.

입력한 내용이 저장되나요?

아니요. 브라우저 안에서만 문서를 만들고 보내지 않습니다. 결과는 직접 복사하거나 내려받아 저장하세요.