첫 번째 Kotlin Notebook 만들기

첫 번째 Kotlin Notebook 만들기 (Create your first Kotlin Notebook)

노트북을 처음 만드는 방법부터 기본 작업까지 순서대로 직접 따라 해 볼게요. 프로젝트를 새로 만들든, 기존 프로젝트에 추가하든, 임시로 만들든 세 가지 방법을 모두 확인할 수 있어요.

출처: Create your first Kotlin Notebook

본문

노트

IntelliJ IDEA 2026.2부터 Kotlin Notebook은 IDE에 번들로 포함되지 않고 JetBrains의 공식 지원도 받지 않게 돼요. 소스 코드는 GitHub에 계속 공개됩니다.

자세한 내용은 블로그 포스트에서 확인하세요.

Kotlin Notebook 작업을 시작하는 방법은 크게 세 가지예요.

  • Kotlin Notebook이 포함된 새 프로젝트 만들기
  • 기존 프로젝트에 Kotlin Notebook 추가하기
  • 임시(scratch) Kotlin Notebook 만들기

새 프로젝트 만들기

Kotlin Notebook이 포함된 새 프로젝트를 만들려면 이렇게 해요.

  • IntelliJ IDEA 환영 화면에서 왼쪽 패널의 Kotlin Notebook | New Notebook을 선택하세요.
  • 새 노트북의 Name을 입력하고 Type에서 선택하세요.
    • Scratch: 프로젝트에 추가하지 않고 임시 노트북을 만드는 옵션이에요.
    • In Folder: 프로젝트 안에 노트북을 만드는 옵션이에요. 프로젝트 위치를 지정해야 해요.
  • Create를 클릭하세요.

[이미지: Create a new Kotlin Notebook from IntelliJ IDEA]

새 Kotlin Notebook은 새 프로젝트 안에 생성돼요.

대신 빈 프로젝트를 먼저 만든 뒤 Kotlin Notebook을 추가할 수도 있어요.

  • IntelliJ IDEA에서 File | New | Project를 선택하세요.
  • 왼쪽 패널에서 New Project를 선택하세요.
  • 새 프로젝트의 이름을 정하고 필요하면 위치를 바꾸세요.

팁 Create Git repository 체크박스를 선택하면 새 프로젝트를 버전 관리 아래에 둘 수 있어요. 나중에 언제든 추가할 수도 있어요.

  • Language 목록에서 Kotlin을 선택하세요.
  • IntelliJ 빌드 시스템을 선택하세요.
  • JDK 목록에서 프로젝트에 사용할 JDK를 선택하세요.
  • Add sample code 옵션을 켜면 샘플 "Hello World!" 애플리케이션이 담긴 파일이 만들어져요.

팁 Generate code with onboarding tips 옵션을 켜서 샘플 코드에 유용한 주석을 추가할 수도 있어요.

  • Create를 클릭하세요.

프로젝트가 만들어지면 새 Kotlin Notebook을 추가하면 돼요(다음 섹션 참고).

프로젝트에 새 Kotlin Notebook 추가하기

기존 프로젝트에 새 Kotlin Notebook을 추가하려면 이렇게 해요.

  • File | New | Kotlin Notebook을 선택하거나, 폴더를 마우스 오른쪽 버튼으로 클릭하고 New | Kotlin Notebook을 선택하세요.
  • 새 노트북의 이름을 정하세요. 예를 들어 first-notebook처럼요.
  • Enter를 누르세요. first-notebook.ipynb라는 Kotlin Notebook이 들어있는 새 탭이 열려요.

임시 Kotlin Notebook 만들기

Kotlin Notebook을 임시(scratch) 파일로 만들 수도 있어요. 임시 파일을 쓰면 새 프로젝트를 만들거나 기존 프로젝트를 수정하지 않고도 작은 코드 조각을 테스트할 수 있어요.

임시 Kotlin Notebook을 만들려면 이렇게 해요.

  • File | New | Scratch File을 클릭하세요.
  • New Scratch File 목록에서 Kotlin Notebook을 선택하세요.

기본 작업 수행하기

  • 새 Kotlin Notebook에서 코드 셀에 다음 코드를 입력하세요.
println("Hello, this is a Kotlin Notebook!")
  • 코드 셀을 실행하려면 Run Cell and Select Below 버튼을 클릭하거나 Shift + Return을 누르세요.
  • Add Markdown Cell 버튼을 클릭해 Markdown 셀을 추가하세요.
  • 셀에 # Example operations을 입력하고, 코드 셀과 같은 방식으로 실행해서 렌더링해 보세요.
  • 새 코드 셀에 10 + 10을 입력하고 실행하세요.
  • 코드 셀에서 변수를 정의해 보세요. 예를 들어 val a = 100처럼요.

팁 변수를 정의한 코드 셀을 실행하면, 그 변수들은 다른 모든 코드 셀에서도 접근할 수 있게 돼요.

  • 새 코드 셀을 만들고 println(a * a)를 추가하세요.
  • Run All 버튼으로 노트북의 모든 코드·Markdown 셀을 실행하세요.

축하합니다! 첫 번째 Kotlin Notebook을 만들고 직접 사용해 봤어요.

다음 단계

튜토리얼의 다음 부분에서는 Kotlin Notebook에 의존성을 추가하는 방법을 배우게 돼요.