4강. 학습 기록 시작하기
0. 학습 목표
→ 폴더의 사용 순서를 확인하고, 기록 계획 노트와 학습일지 노트를 만들어 학습 기록을 시작합니다.
0.1 이번 글에서 다룰 내용
study-notes폴더가 16강까지 사용되는 순서를 확인하고, 이 폴더에 적지 않을 내용을 판단 기준과 함께 제시- 이 폴더가 16강에서 도착하는 곳을 기준으로 학습 기록에 남길 내용과 적지 않을 내용을 판단하고, 그 판단을
notes/study-plan.md에 자기 문장으로 적은 뒤 파일 관리자에서 같은 이름의.md파일이 실제로 생겼는지 확인 - 강의마다 한 일을 적는 학습일지 노트
notes/study-log.md를 만들고, 어느 내용을 어느 노트에 적을지 두 노트의 역할 구분 - 배부받은 강의 요약본 네 편을
lectures폴더에 저장해, 안내 노트의 목록 링크로 각각 열리는 것을 확인
오늘 만드는 노트는 두 개입니다. 기록 계획 노트와 학습일지 노트이며, 두 노트 모두 16강까지 계속 사용합니다. 마지막으로 배부받은 1강부터 4강까지의 강의 요약본을 lectures 폴더에 저장합니다.
0.2 이번 강의 실습 내용
- 1강에서 설치한 Obsidian과
study-notesVault가 열린 상태 - 홈 폴더의
study-notes폴더 - 3강에서 확인한 내용(워드 문서와 마크다운 파일에 같은 명령을 실행했을 때 화면에 나온 것)
- 강사가 배부하는 강의 요약본 파일 네 개(
01-obsidian-install.md,02-text-file-check.md,03-markdown-format.md,04-study-notes.md)
Obsidian이 닫혀 있으면 다시 실행합니다. 마지막에 연 Vault가 그대로 열립니다. 시작 화면이 나오면 1강과 같은 방법으로 홈 폴더의 study-notes를 다시 엽니다.
1. study-notes 폴더의 사용 순서와 기록 원칙 확인하기
→ 폴더가 16강까지 사용되는 순서를 확인하고, 첫 노트를 만들기 전에 지킬 원칙 두 가지를 정합니다.
1.1 폴더가 16강까지 사용되는 순서 확인하기
1강에서 압축을 푼 study-notes 폴더 하나가 16강까지 계속 사용됩니다. 새 폴더를 만들거나 다른 곳으로 옮기지 마세요.
| 강의 | 이 폴더에서 하는 일 |
| 4강 | 기록 계획 노트와 학습일지 노트를 만들고, 배부받은 요약본을 lectures 폴더에 저장한다 |
| 6강 | 마크다운 문법으로 notes 폴더에 학습 노트를 작성한다 |
| 8강, 9강 | 이 폴더를 Claude에 연결해 자료를 근거로 질문한다 |
| 10강 | 이 폴더를 Git 저장소로 만들어 GitHub에 올린다 |
| 15강 | 이 폴더를 주소로 접속할 수 있는 공개 사이트로 만든다 |
| 16강 | 그 주소를 면접이나 평가에서 제시할 수 있는 상태로 정리한다 |
이 순서에서 지켜야 할 원칙이 두 가지 나옵니다. 첫 노트를 만들기 전에 확인합니다.
| 증상 | 원인 | 해결 방법 |
| Obsidian을 실행했는데 시작 화면이 나온다 | 마지막에 연 Vault 정보가 남아 있지 않음 | 1강과 같은 방법으로 [Open folder as vault]에서 홈 폴더의 study-notes를 다시 연다 |
1.2 인터넷에 공개되는 폴더에 적지 않을 내용 확인하기
15강에서 만드는 사이트는 주소를 아는 사람이면 누구나 볼 수 있습니다. 10강에서 GitHub에 올리는 시점부터 이미 공개 상태가 됩니다. 그러므로 다음 내용은 이 폴더 안의 어떤 파일에도 적지 않습니다.
- 전화번호, 주소, 주민등록번호 같은 개인정보
- 계정 아이디와 비밀번호
- GitHub 개인 접근 토큰(10강에서 만듭니다. 비밀번호와 같은 것으로 취급합니다)
6강부터 화면 사진을 노트에 넣게 되는데, 사진 안에 위 내용이 찍혀 있는 경우가 있습니다. 넣기 전에 확인하는 습관이 필요합니다.
⚠ 주의: 한 번 GitHub에 올린 내용은 나중에 파일에서 지우더라도 이전 기록에 남습니다. 지우기보다 처음부터 적지 않는 것이 확실합니다.
3강에서 만든 format-test.docx를 홈 폴더에 둔 것도 같은 이유입니다. 확인용으로 한 번 쓰고 마는 파일이 공개 대상 폴더에 남지 않게 하려는 것입니다. 그 파일은 이후 강의에서 다시 사용하지 않으므로 그대로 두거나 삭제해도 됩니다.
1.3 AI 도구가 생성한 문장을 확인 없이 기록에 옮기지 않는 원칙 확인하기
7강부터 9강까지 Claude에 질문하며 학습합니다. 이때 받은 답변은 참고 자료이지 확인된 사실이 아닙니다. 명령 이름이나 경로가 실제와 다른 경우가 있습니다.
답변을 노트에 남길 때는 다음 순서를 따릅니다. 답변에 나온 명령이나 설명을 직접 실행하거나 원본 자료와 대조해 확인하고, 확인한 결과를 자기 문장으로 적습니다. 확인하지 않고 옮긴 문장은 나중에 자기 기록을 믿을 수 없게 만듭니다.
💡 핵심: 폴더의 사용 순서와 두 가지 원칙(개인정보·계정 정보를 적지 않는다, AI 도구가 생성한 문장을 확인 없이 옮기지 않는다)을 확인했습니다. 이 원칙을 실제 기록 기준으로 만드는 작업을 지금 이어서 합니다.
2. 무엇을 기록할지 정해 기록 계획 노트 만들기
→ 남길 내용과 적지 않을 내용을 판단하고, 그 판단을 study-plan 노트로 작성한 뒤 실제 파일인지 확인합니다.
2.1 남길 내용과 적지 않을 내용 판단하기
앞의 표에서 이 폴더가 도착하는 곳은 면접이나 평가에서 제시하는 공개 주소입니다. 그렇다면 무엇을 적어야 그때 쓸모가 있는지가 오늘의 판단 대상입니다.
완성된 코드와 정리된 결론만 적어 둔 기록은 그 시점에 설명할 거리가 적습니다. 같은 결과는 누구나 만들 수 있기 때문입니다. 남는 것은 다음과 같은 내용입니다.
- 실제로 실행한 명령과 그때 화면에 나온 결과
- 실패했을 때 나온 오류 메시지의 원문
- 그 오류를 어떻게 확인하고 무엇을 고쳐서 해결했는지
- 두 가지 방법 중 하나를 골랐다면 무엇을 근거로 골랐는지
2강과 3강에서 한 작업이 이 네 가지에 그대로 해당합니다. 2강에서는 같은 파일을 마우스로도 열고 명령으로도 열어 두 방법의 결과가 같은 것을 확인했고, 3강에서는 unzip -l을 두 파일에 각각 실행해 한쪽에서는 목록이 나오고 다른 쪽에서는 오류가 나오는 것을 확인했습니다. 오류가 나온 것이 정상이라는 판단도 함께 했습니다. 이런 내용이 남아 있으면 나중에 "마크다운 파일에는 글자만 들어 있다"는 문장 하나보다 설명할 거리가 많습니다.
반대로 적지 않을 것도 정해 두는 편이 낫습니다. 배부받은 강의 요약본에 이미 있는 설명을 노트에 다시 옮겨 적는 것이 대표적입니다. 같은 내용이 두 파일에 나뉘어 있으면 나중에 어느 쪽이 맞는지 판단해야 하고, 옮겨 적는 시간만큼 실습 시간이 줄어듭니다. 요약본의 어느 부분을 봤는지만 적고 넘어가면 됩니다.
앞 절에서 확인한 두 원칙도 여기에 함께 들어갑니다. 개인정보와 계정 정보를 적지 않는다는 것, 그리고 AI 도구가 생성한 문장을 확인 없이 옮기지 않는다는 것입니다.
2.2 기록 계획 노트 작성하기
정한 내용을 노트로 남깁니다. 1강부터 3강까지는 파일을 열어 보기만 했고, 이번이 Obsidian에서 노트를 직접 만드는 첫 작업입니다.
- 왼쪽 파일 목록에서
notes폴더를 마우스 오른쪽 버튼으로 누르고 [New note](새 노트)를 선택합니다. - 노트 이름을
study-plan으로 입력하고Enter키를 누릅니다. 파일 이름은 1강에서 확인한 규칙대로 영문 소문자와 붙임표만 사용합니다. 확장자.md는 입력하지 않아도 자동으로 붙습니다. - 편집 영역에 다음 틀을 입력한 뒤 각 항목을 자기 문장으로 채웁니다. 파일 이름은 영문이지만 문서 안의 제목은 한국어로 적습니다. 첫 줄의
#은 제목을 표시하는 마크다운 기호이고-는 목록을 표시하는 기호입니다. 문법은 5강과 6강에서 다루므로 지금은 이 형태 그대로 적으면 됩니다.
작성 예시는 다음과 같습니다. 그대로 베끼지 말고 3강에서 자기 화면에 나온 내용으로 고쳐 적습니다.
# 나의 학습 기록 계획
## 3강에서 확인한 것
- 워드 문서에 file, gnome-text-editor, unzip -l을 실행했을 때: file은 Microsoft Word 형식으로
판정했고, 편집기에서는 입력한 문장이 안 보였고, unzip -l 목록에는 word/document.xml을
포함해 XML 파일이 다섯 개 넘게 나왔다.
- 마크다운 파일에 같은 세 명령을 실행했을 때: file은 UTF-8 text로 판정했고, 편집기에서
내용이 그대로 보였고 #과 - 기호도 글자로 보였다. unzip -l은 압축 파일이 아니라는 오류가 나왔다.
- 학습 기록의 원본을 마크다운으로 두는 이유 중 내가 가장 먼저 쓰게 될 것:
10강에서 Git이 어느 줄이 바뀌었는지 기록하려면 글자만 있는 파일이어야 한다는 점
## 남길 것
- 직접 실행한 명령과 화면에 나온 결과
- 오류 메시지는 요약하지 않고 나온 문장 그대로
- 오류를 해결한 방법과 그때 확인한 것
- 두 방법 중 하나를 고른 경우 그 근거
## 적지 않을 것
- 강의 요약본에 이미 있는 설명. 어느 부분을 봤는지만 적는다
- 개인정보와 계정 정보. 이 폴더는 10강부터 공개된다
- 확인하지 않은 AI 도구의 답변
## 적는 시점
- 실습이 끝난 뒤가 아니라 오류가 났을 때 바로 적는다
Ctrl+E로 읽기 모드로 전환합니다.#을 붙인 줄이 제목으로,-를 붙인 줄이 점 목록으로 표시되면 올바르게 입력된 것입니다.- 오른쪽 사이드바의 [Outline] 탭을 봅니다. 방금 입력한
##제목 네 개가 목록으로 표시됩니다. 1강에서 켜 둔 개요 기능이 내가 만든 노트에도 그대로 동작하는지 확인하는 것입니다.
Obsidian은 별도의 저장 버튼 없이 입력하는 즉시 파일에 자동 저장됩니다. Ctrl+S를 누를 필요가 없습니다.
| 증상 | 원인 | 해결 방법 |
새 노트가 notes 폴더가 아니라 다른 곳에 만들어졌다 |
오른쪽 클릭한 대상이 다른 폴더이거나 파일 목록의 빈 곳임 | 왼쪽 목록에서 그 노트를 notes 폴더 위로 끌어다 놓아 옮긴다 |
| 노트 이름을 바꾸고 싶다 | — | 왼쪽 목록에서 노트를 오른쪽 클릭하고 [Rename]을 선택한다 |
| 한글 입력이 안 된다 | Ubuntu 입력기가 영문으로 되어 있음 | 입력기 전환 키는 실습실 PC 설정에 따라 다르므로 강사가 안내하는 키를 사용한다. 해결되지 않으면 강사에게 알린다 |
#을 붙였는데 읽기 모드에서 제목으로 표시되지 않는다 |
#과 글자 사이에 공백이 없음 |
#제목이 아니라 # 제목처럼 기호 뒤에 공백을 하나 넣는다 |
| 오른쪽 사이드바의 [Outline] 탭이 비어 있다 | 노트에 # 제목이 아직 없거나 개요 기능이 꺼져 있다 |
제목 줄을 먼저 입력한다. 그래도 비어 있으면 설정 → [Core plugins]에서 [Outline]이 켜져 있는지 확인한다 |
| 코드 블록 안의 예시를 그대로 붙여 넣었더니 뒤 내용이 이상해진다 | 예시 안의 세 개짜리 기호까지 함께 복사함 | 예시는 보고 직접 입력한다. 이 기호의 뜻은 6강에서 다룬다 |
2.3 만든 노트가 실제 파일인지 확인하기
파일 관리자로 홈 폴더의 study-notes/notes를 열어 보면 방금 만든 study-plan.md 파일이 실제로 생겨 있습니다.
1강과 2강에서는 파일 관리자에 이미 있던 파일을 Obsidian으로 열어 확인했고, 이번에는 반대 방향입니다. Obsidian에서 만든 노트가 곧 내 컴퓨터의 마크다운 파일이라는 것이 양쪽 방향으로 확인됩니다.
2강에서 확인한 것을 여기에도 적용할 수 있습니다. 쉘 프롬프트에서 다음 두 명령을 실행하면 방금 Obsidian에서 입력한 내용이 그대로 보이고, 파일 종류도 텍스트로 판정됩니다.
쉘 프롬프트
# 만든 노트의 파일 종류와 내용 확인
file ~/study-notes/notes/study-plan.md
gnome-text-editor ~/study-notes/notes/study-plan.md
Obsidian이 만든 파일도 특별한 형식이 아니라 글자만 담긴 텍스트 파일이라는 확인입니다. 확인이 끝나면 수정하지 말고 창을 닫습니다.
3. 학습일지 노트를 만들고 기록 계획 노트와 역할 구분하기
→ 강의마다 한 일을 적는 study-log 노트를 만들고, 두 노트를 나누어 쓰는 기준을 정합니다.
3.1 학습일지 노트 작성하기
두 번째 노트는 강의마다 한 일을 적는 학습일지입니다. 기록 계획 노트와 같은 방법으로 만듭니다.
notes폴더를 마우스 오른쪽 버튼으로 누르고 [New note]를 선택합니다.- 노트 이름을
study-log로 입력하고Enter키를 누릅니다. - 다음 내용을 입력합니다. 1강부터 3강까지의 항목은 자기 화면에 나온 내용으로 고쳐 적습니다.
# 학습일지
## 1강. Obsidian 설치와 Vault 열기
- Obsidian을 설치하고 study-notes 폴더를 Vault로 열었다.
- 파일 관리자에서 본 폴더 세 개와 index 파일이 Obsidian 목록과 같았다.
- Minimal 테마와 Minimal Theme Settings를 적용하고 Colorful active states를 켜서
파일 목록에서 열려 있는 파일이 강조 색으로 보이게 했다.
- 코어 플러그인 Outline을 켜서 오른쪽 사이드바에 제목 목록을 띄웠다.
## 2강. 노트 파일이 텍스트 파일인지 확인
- markdown-syntax.md를 파일 관리자에서 오른쪽 클릭해 텍스트 편집기로 열었더니
읽을 수 없는 문자 없이 내용이 그대로 보였다.
- 같은 파일을 gnome-text-editor 명령으로도 열었고 결과가 같았다.
- file 명령의 출력은 UTF-8 text였다.
- 텍스트 편집기에서 한 줄을 추가했더니 Obsidian 화면에도 나타났다.
두 프로그램이 같은 파일 하나를 열고 있었다.
## 3강. 워드 문서와 마크다운 파일의 저장 방식 비교
- format-test.docx를 만들어 텍스트 편집기로 열었더니 입력한 문장이 보이지 않았다.
- unzip -l 출력에 word/document.xml이 있었다. 서식은 word/styles.xml에 따로 있었다.
- 같은 명령을 markdown-syntax.md에 실행하니 압축 파일이 아니라는 오류가 나왔다.
- 학습 기록의 원본을 마크다운으로 두는 이유 세 가지를 정리했다.
## 4강. 학습 기록 시작
- study-notes 폴더가 16강까지 쓰이는 순서와 기록 원칙 두 가지를 확인했다.
- 기록 계획 노트 study-plan을 만들었다.
- 학습일지 노트 study-log를 만들었다.
Ctrl+E로 읽기 모드에서 표시 결과를 확인합니다.
3.2 두 노트의 역할 구분하기
노트 두 개의 용도가 다릅니다. 앞으로 어느 노트에 적을지 판단해야 하므로 구분해 둡니다.
| 노트 | 적는 내용 | 고치는 시점 |
study-plan |
무엇을 남기고 무엇을 남기지 않을지에 대한 기준 | 기준을 바꿀 때만 |
study-log |
강의마다 실제로 한 일, 실행한 명령, 나온 결과와 오류 | 강의마다 |
study-plan에 적은 기준을 study-log에 다시 옮겨 적지 않습니다. 같은 내용이 두 파일에 나뉘어 있으면 나중에 어느 쪽이 최신인지 판단해야 하기 때문입니다. 학습일지를 쓸 때 기준이 기억나지 않으면 study-plan 노트를 함께 열어 두면 됩니다.
4. 배부받은 강의 요약본을 lectures 폴더에 저장하기
→ 요약본 파일 네 개를 lectures 폴더에 넣고, 안내 노트의 목록 링크로 각각 열리는지 확인합니다.
4.1 요약본 네 파일을 옮기고 목록 링크로 확인하기
강사가 1강부터 4강까지의 강의 요약본 파일 네 개를 배부합니다.
01-obsidian-install.md, 02-text-file-check.md, 03-markdown-format.md, 04-study-notes.md입니다. 요약본에는 그 강의의 학습 목표, 실습 절차, 명령, 확인 항목이 정리되어 있고 맨 아래에 내 메모 절이 있습니다.
- 파일 관리자에서 배부받은 네 파일을 홈 폴더의
study-notes/lectures폴더로 옮깁니다. - Obsidian 화면으로 돌아가 왼쪽 파일 목록의
lectures폴더를 펼칩니다. 방금 옮긴 네 파일이 나타납니다. 파일 관리자에서 폴더에 넣은 파일이 Obsidian 목록에 바로 나타나는 것도, Obsidian이 폴더 자체를 보여 준다는 1강의 확인 결과와 같은 내용입니다. lectures폴더의index노트를 누르고Ctrl+E로 읽기 모드로 전환합니다.## 받은 요약본 목록에 요약본 이름이 미리 적혀 있습니다.- 목록의 각 줄을 차례로 눌러 요약본이 각각 열리는지 확인합니다.
목록의 링크가 모두 열리면 됩니다. 이 목록은 배부 시점에 미리 적혀 있던 것이고, 파일을 넣지 않은 상태에서 눌렀다면 페이지를 찾을 수 없다는 화면이 나왔을 것입니다.
앞으로 5강부터는 요약본을 받을 때마다 이 목록에 한 줄씩 직접 추가합니다. 추가하는 방법은 링크 문법을 다루는 6강에서 배웁니다.
| 증상 | 원인 | 해결 방법 |
lectures 폴더에 파일을 넣었는데 Obsidian 목록에 안 보인다 |
다른 폴더에 넣었거나 파일 확장자가 .md가 아님 |
파일 관리자에서 홈 폴더의 study-notes/lectures 경로를 다시 확인한다. Obsidian은 .md 파일만 노트로 표시한다 |
| 요약본 목록의 링크를 눌러도 아무 일도 없다 | 읽기 모드가 아니라 편집 모드임 | Ctrl+E로 읽기 모드로 전환한 뒤 다시 누른다 |
| 요약본 목록의 링크를 눌렀는데 페이지를 찾을 수 없다고 나온다 | 넣은 파일의 이름이 목록에 적힌 이름과 다르다 | 파일 관리자에서 파일 이름을 목록에 적힌 이름과 같게 맞춘다. 이름이 다르면 링크가 그 파일을 찾지 못한다 |
5. 오늘 만든 상태를 확인하고 5강 학습으로 연결하기
→ 오늘 만든 노트와 요약본의 상태를 점검하고, 5강에서 이어질 마크다운 문법 학습을 확인합니다.
5.1 오늘 만든 상태 점검하기
다음 다섯 가지가 모두 확인되면 4강에서 만들어야 할 상태가 갖춰진 것입니다.
- Obsidian의
notes폴더에study-plan과study-log두 노트가 있습니다. study-plan노트의## 3강에서 확인한 것세 항목과## 남길 것,## 적지 않을 것이 자기 문장으로 채워져 있습니다.- 파일 관리자에서 홈 폴더의
study-notes/notes를 열면index.md,study-plan.md,study-log.md세 파일이 있습니다. lectures폴더의index노트를 읽기 모드로 열어 목록의 각 줄을 눌렀을 때 요약본이 각각 열립니다.- 이 폴더에 개인정보와 계정 정보를 적지 않는 이유를 강의 번호(10강, 15강)와 함께 설명할 수 있습니다.
3번이 확인되지 않으면 노트를 다른 폴더에 만든 것입니다. 쉘 프롬프트에서 다음 명령으로 파일의 위치를 확인합니다.
쉘 프롬프트
# notes 폴더의 파일 목록 확인
ls ~/study-notes/notes/
index.md, study-plan.md, study-log.md 세 이름이 출력되어야 합니다. 빠진 파일이 있으면 Obsidian 왼쪽 목록에서 그 노트를 notes 폴더로 끌어다 놓아 옮깁니다.
오늘 강의를 마친 뒤의 학습 자료 폴더 상태
study-notes/
├── index.md # 🗸 1강에서 확인 완료
├── lectures/
│ ├── index.md # 🗸 목록 링크 확인 완료
│ ├── 01-obsidian-install.md # ✏️ 이번 강의에서 저장
│ ├── 02-text-file-check.md # ✏️ 이번 강의에서 저장
│ ├── 03-markdown-format.md # ✏️ 이번 강의에서 저장
│ └── 04-study-notes.md # ✏️ 이번 강의에서 저장
├── notes/
│ ├── index.md # 🗸 1강에서 확인 완료
│ ├── study-plan.md # ✏️ 이번 강의에서 작성
│ └── study-log.md # ✏️ 이번 강의에서 작성
└── reference/
├── index.md # 🗸 1강에서 확인 완료
└── markdown-syntax.md # 🗸 원래 상태 유지. 6강 실습에 사용
✔ 정리: study-notes 폴더의 사용 순서와 기록 원칙 두 가지를 확인하고, 기록 계획 노트 study-plan과 학습일지 노트 study-log를 만들었으며, 강의 요약본 네 편을 lectures 폴더에 저장해 목록 링크로 열리는 것을 확인했습니다.
오늘 만든 두 노트에서 #과 - 기호가 제목과 목록으로 바뀌는 것을 봤습니다. 이 기호 규칙의 이름이 마크다운입니다.
→ 다음 개별 강의
5강에서는 마크다운 기호가 화면에서 문서 구조로 바뀌는 것을 확인하고 이 과정에서 사용할 문법의 범위를 정합니다. 6강 실습에는 2강에서 열어 본 reference 폴더의 markdown-syntax 노트를 그대로 사용하니 따로 준비할 것은 없습니다.