GitHub의 프로젝트 공식 documentation을 노트북LM으로 불러서 사용하려면 파일 갯수 제한 때문에 pdf 등으로 하나의 파일을 만들 필요가 있습니다. 이럴 때 문서는 대부분 *.md 파일로 만들어져 있기 때문에 이 md 파일들을 하나로 합쳐서 노트북LM에 불러오면, 간단하게 해당 프로젝트의 문서를 가지고 노트북LM과 일할 수 있습니다.
구글의 NotebookLM은 개인 문서를 불러와 그 위에서 대화형 질문/답변을 할 수 있는 매우 유용한 도구입니다. 하지만 이를 제대로 활용하려면, 원하는 문서를 하나의 파일로 정리해두는 것이 중요합니다. 특히 GitHub에 올라와 있는 오픈소스 프로젝트의 문서를 분석하고 싶을 때, 대부분은 README.md를 포함한 여러 개의 .md (마크다운) 파일로 구성되어 있기 때문에, 이를 하나로 통합해서 NotebookLM에 업로드하는 방식이 가장 간단하고 효율적입니다.
Step 1. GitHub 프로젝트 클론하기
우선 분석하고 싶은 GitHub 프로젝트를 클론합니다. 예를 들어 아래처럼 입력하면 됩니다.
git clone https://github.com/sample/Ultimate-Tool.git
cd Ultimate-ToolStep 2. 모든 .md 파일을 하나로 합치기
다음으로는 프로젝트 폴더 내에 있는 모든 .md 파일을 하나의 파일로 합칩니다. 터미널(혹은 Git Bash, Zsh 등)에서 아래 명령어를 실행해 주세요.
find . -name "*.md" -exec cat {} \; > ../Ultimate-Tool_docs_combined.md위 명령어는 현재 디렉토리와 그 하위 폴더에 존재하는 모든 .md 파일을 찾아 내용을 읽고, Ultimate-Tool_docs_combined.md라는 하나의 파일로 통합해줍니다. 이 파일은 상위 폴더에 저장됩니다.
Step 3. NotebookLM에 업로드하기
이제 준비는 끝났습니다. NotebookLM에 접속해 새로운 노트북을 만들고, 앞에서 만든 Ultimate-Tool_docs_combined.md 파일을 업로드해 주세요.
업로드가 완료되면, 이제 NotebookLM이 이 문서를 학습한 상태에서 대화를 시작할 수 있습니다. 예를 들어 다음과 같은 질문이 가능합니다:
- “이 프로젝트의 설치 방법을 알려줘.”
- “이 도구가 제공하는 주요 기능은 뭐야?”
- “라이선스는 어떤 형태야?”
- “이 프로젝트를 확장하려면 어떤 부분을 수정해야 해?”
활용 팁
복잡한 기술 문서나 라이브러리 구조를 이해할 때, NotebookLM은 훌륭한 파트너가 됩니다. 특히 다음과 같은 경우에 강력한 효율을 발휘합니다:
- 기존 오픈소스의 문서 구조가 복잡하고 파일이 여러 개일 때
- README 외의 문서까지 포함해 전반적인 프로젝트 흐름을 파악하고 싶을 때
- 기술 문서를 기반으로 빠르게 요약, 정리, FAQ를 만들고 싶을 때
마무리
단 몇 줄의 명령어만으로, GitHub의 문서를 NotebookLM에서 바로 활용할 수 있는 형태로 바꾸는 방법을 소개해드렸습니다. 이 방식은 단순하지만 매우 강력하며, 개발자뿐 아니라 기획자, 기술 마케터 등에게도 유용하게 활용될 수 있습니다.
이제 여러분의 기술 탐험을 NotebookLM과 함께 더 빠르고 똑똑하게 진행해보세요!