기술 용어는 외국어처럼 들릴 뿐입니다
새로운 도구를 배울 때 가장 먼저 우리를 막아서는 것은 기능이 아닙니다. 용어입니다. 화면에 Repository, Commit, Push, Pull 같은 단어가 나타나는 순간 머릿속에 작은 경고등이 켜집니다. "아, 이건 개발자들이 쓰는 거구나. 내가 건드리면 안 되는 영역인가 보다."
하지만 잠시만 관점을 바꿔 봅시다. 우리가 강의장에서 쓰는 말도 처음 듣는 사람에게는 어렵습니다. "러닝 목표", "퍼실리테이션", "프롬프트 엔지니어링", "실습 시나리오" 같은 말은 강사에게는 익숙하지만 입문자에게는 낯섭니다. 그렇다고 그 개념이 불가능하게 어려운 것은 아닙니다. 한 번 자기 언어로 번역되면 금방 익숙해집니다.
옵시디언과 깃허브도 마찬가지입니다. 이 장의 목표는 여러분을 기술 전문가로 만드는 것이 아닙니다. 앞으로 책에서 반복해서 나올 단어들을 겁먹지 않고 읽을 수 있게 만드는 것입니다. 지금은 정확한 내부 원리보다 "내 업무에서 이게 무엇을 뜻하는지"를 잡는 것이 중요합니다.
이 장을 읽고 나면 적어도 이런 문장을 이해할 수 있어야 합니다.
"옵시디언 볼트에 마크다운 노트를 작성한 뒤, 변경 내용을 커밋하고 깃허브 저장소에 푸시하세요. 다른 사람이 수정한 내용이 있으면 먼저 풀을 받아 최신 상태로 맞추세요."
처음 보면 암호문 같지만, 번역하면 이렇게 됩니다.
"내 지식 창고 폴더에 문서를 작성한 뒤, 지금 상태를 저장 지점으로 남기고 온라인 폴더에 올리세요. 동료가 먼저 고친 내용이 있으면 내 컴퓨터로 최신 내용을 가져와서 맞추세요."
갑자기 조금 쉬워졌습니다. 이 장은 바로 이 번역 작업을 함께하는 시간입니다.
옵시디언 볼트는 내 지식 창고 폴더입니다
옵시디언에서 가장 먼저 만나는 단어는 볼트Vault입니다. 영어로 금고, 보관소라는 뜻이 있습니다. 이름만 들으면 거창하지만, 실제로는 어렵지 않습니다.
옵시디언에서 볼트는 내 노트들이 들어 있는 하나의 폴더입니다.
예를 들어 우리 커뮤니티의 한 강사가 컴퓨터에 AI강의_지식창고라는 폴더를 만들었다고 해 봅시다. 그 안에 강의 아이디어, 프롬프트 예시, 수강생 질문, 실습 자료, 참고 링크를 차곡차곡 넣습니다. 옵시디언은 이 폴더를 열어서 보기 좋게 보여 주고, 노트끼리 연결하고, 검색하고, 편집할 수 있게 도와줍니다. 이때 그 폴더 전체를 옵시디언에서는 볼트라고 부릅니다.
그러니 볼트를 어렵게 생각하지 마세요. 볼트는 앱 안 어딘가에 숨어 있는 비밀 공간이 아닙니다. 내 컴퓨터 안에 실제로 존재하는 폴더입니다. 옵시디언을 지워도 폴더와 파일은 남아 있습니다. 이 점이 중요합니다. 내 지식이 특정 앱 속에 갇히지 않고, 파일 형태로 내 손에 남기 때문입니다.
강사 업무에 빗대면 볼트는 개인 연구실의 큰 서랍장입니다. 그 안에 강의 노트 서랍, 프롬프트 서랍, 수강생 질문 서랍, 공개 콘텐츠 초안 서랍을 만드는 식입니다. 앞으로 3장과 4장에서 우리는 이 볼트를 실제로 만들고, 강사 커뮤니티에 맞게 폴더 구조를 잡아 볼 것입니다.
노트는 마크다운 문서입니다
옵시디언 안에서 우리가 작성하는 한 장의 글을 보통 노트Note라고 부릅니다. 노트라고 하면 앱 전용 문서처럼 느껴질 수 있지만, 실제로는 대부분 .md라는 확장자를 가진 마크다운Markdown 파일입니다.
마크다운은 글을 꾸미는 아주 가벼운 약속입니다. 워드 문서처럼 메뉴를 눌러 글자 크기를 바꾸는 대신, 글 앞에 간단한 표시를 붙입니다. 예를 들어 ##를 붙이면 소제목이 되고, -를 붙이면 목록이 됩니다. 중요한 말처럼 별표 두 개로 감싸면 굵게 표시됩니다.
여기서 핵심은 문법을 많이 외우는 것이 아닙니다. 마크다운은 메모장에서도 열리는 가벼운 문서 형식이라는 점을 이해하면 충분합니다.
강사 입장에서 마크다운 노트는 이런 자료를 담기에 좋습니다.
강의 중 자주 받는 질문과 답변
챗GPT 실습용 프롬프트와 개선 기록
수강생 반응이 좋았던 비유와 설명 문장
커리큘럼 아이디어와 회고 메모
공개 글로 발전시킬 초안
처음부터 예쁘게 쓰려고 하지 않아도 됩니다. 마크다운의 장점은 빠르게 쓰고, 나중에 정리하기 쉽다는 데 있습니다. 강의가 끝난 직후 떠오른 한 줄을 붙잡아 두고, 며칠 뒤 그 한 줄을 강의안 문장으로 키울 수 있습니다.
우리는 앞으로 마크다운을 "개발자 문서 문법"이 아니라 "강사의 생각을 오래 남기는 간단한 글쓰기 방식"으로 사용할 것입니다.
링크는 노트 사이의 지름길입니다
옵시디언을 특별하게 만드는 기능 중 하나가 링크Link입니다. 링크는 한 노트에서 다른 노트로 이동하는 지름길입니다.
인터넷에서 링크를 누르면 다른 웹페이지로 이동합니다. 옵시디언에서도 비슷합니다. 다만 웹사이트가 아니라 내 볼트 안의 다른 노트로 이동합니다. 예를 들어 수강생이 AI를 어려워하는 이유라는 노트에서 프롬프트 작성 3단계라는 노트로 연결할 수 있습니다. 그러면 나중에 관련 내용을 따라가며 읽을 수 있습니다.
강의 준비를 하다 보면 지식은 한 줄로 정리되지 않습니다. 수강생 질문은 프롬프트 설명과 연결되고, 프롬프트 설명은 실습 예제와 연결되고, 실습 예제는 강의 시간 배분과 연결됩니다. 폴더만으로는 이런 관계를 모두 표현하기 어렵습니다.
링크는 이 관계를 살려 줍니다. 종이 노트로 치면 "이 내용은 저 페이지도 참고"라고 적어 둔 표시입니다. 강사의 머릿속에서만 이어져 있던 경험을 노트 사이의 길로 만들어 주는 것입니다.
옵시디언에서는 보통 대괄호 두 개를 사용해 노트를 연결합니다. 예를 들어 [[프롬프트 작성 3단계]]처럼 적으면 해당 노트로 가는 링크가 됩니다. 지금은 이 문법을 완벽히 외울 필요가 없습니다. 중요한 것은 링크를 "노트 사이에 놓는 지름길"로 이해하는 것입니다.
이 지름길이 많아질수록 볼트는 단순한 파일 보관함이 아니라 지식 지도처럼 변합니다. 예전에는 잊혔던 메모가 어느 날 다른 노트와 연결되면서 새로운 강의 아이디어가 되기도 합니다.
저장소는 변경 이력이 남는 온라인 폴더입니다
이제 깃허브 쪽 용어로 넘어가 보겠습니다. 깃허브에서 가장 중요한 단어는 저장소Repository입니다. 줄여서 레포Repo라고 부르기도 합니다.
저장소는 쉽게 말해 온라인에 있는 프로젝트 폴더입니다. 그런데 일반 온라인 폴더와 결정적으로 다른 점이 있습니다. 저장소는 파일만 보관하는 것이 아니라 변경 이력을 함께 기억합니다.
일반 폴더에서는 누가 언제 어떤 문장을 바꿨는지 알기 어렵습니다. 그래서 우리는 파일 이름에 날짜나 버전을 붙입니다. 강의안_최종, 강의안_최종수정, 강의안_진짜최종, 강의안_진짜최종_발표용 같은 파일이 생깁니다. 다들 한 번쯤 겪어 본 풍경입니다.
깃허브 저장소에서는 이런 혼란을 줄일 수 있습니다. 파일을 고친 뒤 "이번 변경은 이런 이유로 남깁니다"라고 저장 지점을 만들면, 나중에 그 시점으로 돌아가거나 변경 내용을 비교할 수 있습니다.
강사 커뮤니티 기준으로 저장소는 이렇게 이해하면 됩니다.
개인 저장소: 내 강의 노트와 실험 기록을 백업하는 온라인 폴더입니다.
내부 저장소: 커뮤니티 구성원끼리만 공유하는 공동 자료실입니다.
공개 저장소: 외부에 보여 줄 자료를 정리하는 공개 자료실입니다.
여기서 "저장소 하나에 모든 것을 다 넣으면 안 되나요?"라는 질문이 나올 수 있습니다. 기술적으로는 가능할 수 있습니다. 하지만 운영상으로는 추천하지 않습니다. 공개할 자료와 숨겨야 할 자료가 섞이면 언젠가 실수가 납니다. 처음부터 저장소를 역할별로 나누면 초보자도 훨씬 안전하게 운영할 수 있습니다.
Public과 Private은 문이 열린 방과 잠긴 방의 차이입니다
깃허브 저장소를 만들 때 중요한 선택지가 나옵니다. Public으로 만들 것인지, Private으로 만들 것인지입니다.
Public 저장소는 말 그대로 공개 저장소입니다. 인터넷에 접속한 사람이 볼 수 있는 열린 방에 가깝습니다. 검색에 노출될 수도 있고, 링크를 아는 사람이 들어와 내용을 확인할 수도 있습니다. 공개 강의 자료, 샘플 프롬프트, 블로그 글 초안, 커뮤니티 소개 문서처럼 외부에 보여 줘도 되는 자료를 담기에 적합합니다.
Private 저장소는 비공개 저장소입니다. 초대받은 사람만 볼 수 있는 잠긴 방에 가깝습니다. 내부 강의 운영 매뉴얼, 유료 강의안 초안, 커뮤니티 회의록, 강사 전용 체크리스트처럼 외부에 공개하면 곤란한 자료는 Private 저장소에 두어야 합니다.
다만 여기서 꼭 기억해야 할 점이 있습니다. Private은 "아무거나 넣어도 되는 절대 금고"가 아닙니다. 주민등록번호, 고객사의 민감한 내부 정보, 비밀번호, API 키처럼 유출되면 큰 문제가 되는 정보는 애초에 옵시디언 볼트나 깃허브 저장소에 넣지 않는 편이 안전합니다. 비공개 방이라고 해도 위험한 물건을 쌓아 두면 관리 부담이 커집니다.
초보 단계에서는 다음 기준으로 판단하면 쉽습니다.
외부 사람이 봐도 커뮤니티에 도움이 되고 문제가 없다면 Public 후보입니다.
구성원끼리만 알아야 하는 노하우라면 Private 후보입니다.
개인정보, 비밀번호, 고객사 기밀처럼 민감한 정보라면 저장소에 넣지 않는 것이 원칙입니다.
우리 커뮤니티의 목표는 단순히 자료를 숨기는 것이 아닙니다. 공개할 것은 잘 공개해서 영향력을 키우고, 보호할 것은 제대로 보호해서 신뢰를 지키는 것입니다.
커밋은 저장 지점 만들기입니다
깃허브를 배우다 보면 가장 자주 만나는 단어가 커밋Commit입니다. 처음 들으면 딱딱하지만, 강사 업무에 비유하면 아주 쉽습니다.
커밋은 지금 상태를 저장 지점으로 남기는 행동입니다.
파워포인트 작업을 하다가 중요한 수정이 끝나면 우리는 저장 버튼을 누릅니다. 게임을 하다가 중요한 단계에 도착하면 세이브 포인트를 만듭니다. 커밋은 이와 비슷합니다. 다만 단순 저장보다 조금 더 똑똑합니다. "어떤 파일이 어떻게 바뀌었는지"와 "왜 이 시점에 저장했는지"를 함께 남길 수 있기 때문입니다.
예를 들어 내부 강의 노트에서 프롬프트 예시를 개선했다고 해 봅시다. 이때 커밋 메시지를 이렇게 남길 수 있습니다.
프롬프트 예시를 초보자용 표현으로 수정
나중에 이 기록을 보면 그날 무엇을 했는지 바로 알 수 있습니다. "아, 이때 어려운 표현을 쉬운 표현으로 바꿨구나" 하고 이해할 수 있습니다. 혼자 작업할 때도 유용하고, 여러 사람이 함께 작업할 때는 더 중요합니다.
좋은 커밋 메시지는 길고 화려할 필요가 없습니다. 초보 단계에서는 "무엇을 바꿨는지"만 적어도 충분합니다. 예를 들면 수강생 질문 FAQ 추가, 강의 준비 체크리스트 수정, 공개용 프롬프트 예시 정리처럼 쓰면 됩니다.
커밋을 한마디로 줄이면 이렇습니다.
커밋은 "여기까지 작업했어요"라고 표시하는 저장 지점입니다.
푸시는 깃허브에 올리기입니다
커밋을 했다고 해서 자동으로 깃허브 웹사이트에 올라가는 것은 아닙니다. 내 컴퓨터 안에서 저장 지점을 만든 상태일 수 있습니다. 이 저장 지점을 온라인 저장소로 보내는 행동이 푸시Push입니다.
푸시는 말 그대로 "밀어 올리기"입니다. 내 컴퓨터에 있는 변경 내용을 깃허브 저장소로 올리는 것입니다.
강사 업무로 비유해 보겠습니다. 내가 개인 노트북에서 강의안을 수정했습니다. 수정한 내용을 커밋했습니다. 하지만 아직 내 노트북 안에만 있다면 다른 구성원은 볼 수 없습니다. 이때 푸시를 해야 깃허브의 공동 저장소에 반영됩니다. 그러면 초대받은 동료들도 그 변경 내용을 확인할 수 있습니다.
푸시를 하지 않는 것은 작성한 회의록을 내 컴퓨터에만 저장해 두고 공유 폴더에는 올리지 않은 것과 비슷합니다. 나는 분명히 썼지만, 팀은 모릅니다. 그래서 협업에서는 커밋만큼이나 푸시 습관이 중요합니다.
초보자가 기억할 문장은 간단합니다.
커밋은 내 컴퓨터에서 저장 지점을 만드는 것, 푸시는 그 저장 지점을 깃허브에 올리는 것입니다.
이 둘을 헷갈려도 괜찮습니다. 처음에는 누구나 헷갈립니다. 중요한 것은 작업 흐름을 몸에 익히는 것입니다. "수정했다 → 커밋했다 → 푸시했다." 이 세 박자를 반복하면 됩니다.
풀은 깃허브에서 최신 내용 가져오기입니다
협업을 시작하면 내 컴퓨터만 생각해서는 안 됩니다. 다른 구성원도 같은 저장소를 수정할 수 있기 때문입니다. 누군가가 먼저 자료를 고쳐서 깃허브에 올렸다면, 내 컴퓨터의 파일은 최신 상태가 아닐 수 있습니다. 이때 필요한 행동이 풀Pull입니다.
풀은 깃허브에 있는 최신 내용을 내 컴퓨터로 가져오는 것입니다.
예를 들어 커뮤니티 내부 저장소에 AI 입문 강의 FAQ.md라는 노트가 있다고 해 봅시다. 어제 동료 강사가 여기에 새로운 수강생 질문 5개를 추가하고 푸시했습니다. 그런데 나는 오늘 아침 내 컴퓨터에서 예전 파일을 열고 수정하려고 합니다. 이때 먼저 풀을 하지 않으면, 동료가 추가한 최신 내용이 내 컴퓨터에 없을 수 있습니다.
이 상태에서 내가 바로 수정하고 올리면 나중에 내용이 꼬일 수 있습니다. 그래서 공동 작업에서는 작업을 시작하기 전에 먼저 풀을 받아 최신 상태로 맞추는 습관이 중요합니다.
협업의 기본 순서는 이렇게 기억하면 됩니다.
시작할 때: 풀로 최신 내용을 가져옵니다.
작업한 뒤: 커밋으로 저장 지점을 만듭니다.
마무리할 때: 푸시로 깃허브에 올립니다.
이 흐름은 식당의 공동 냉장고를 쓰는 것과 비슷합니다. 요리를 시작하기 전에 냉장고에 어떤 재료가 새로 들어왔는지 확인합니다. 내가 재료를 추가하거나 정리한 뒤에는 다른 사람도 볼 수 있게 표시해 둡니다. 서로 최신 상태를 확인하지 않으면 같은 재료를 중복으로 사거나, 누군가 준비한 재료를 모르고 지나칠 수 있습니다.
풀을 한마디로 줄이면 이렇습니다.
풀은 "다른 사람이 올린 최신 자료를 내 쪽으로 가져오기"입니다.
동기화와 백업은 같은 말이 아닙니다
많은 분들이 헷갈리는 단어가 있습니다. 동기화Sync와 백업Backup입니다. 둘 다 파일을 안전하게 보관하는 느낌이 있어서 비슷해 보입니다. 하지만 실제 의미는 다릅니다.
동기화는 여러 기기의 내용을 같게 맞추는 것입니다. 예를 들어 노트북에서 쓴 노트가 태블릿에도 나타나고, 태블릿에서 고친 내용이 다시 노트북에도 반영되는 식입니다. 동기화의 핵심은 "어디서 열어도 같은 상태로 보이게 하기"입니다.
백업은 문제가 생겼을 때 되돌아갈 사본을 남기는 것입니다. 컴퓨터가 고장 나거나, 파일을 실수로 지우거나, 내용을 잘못 수정했을 때 복구할 수 있도록 따로 보관하는 것이 백업입니다.
둘의 차이는 사고가 났을 때 드러납니다. 만약 단순 동기화만 사용한다면, 한 기기에서 파일을 실수로 삭제했을 때 그 삭제가 다른 기기에도 빠르게 반영될 수 있습니다. 모든 기기가 똑같이 "삭제된 상태"가 되는 것입니다. 동기화는 빠르지만, 실수까지 빠르게 퍼뜨릴 수 있습니다.
반면 깃허브를 이용해 커밋 기록을 남기면 이전 저장 지점을 확인할 수 있습니다. 물론 설정과 사용 방식에 따라 차이는 있지만, 핵심은 변경 이력이 남는다는 점입니다. 단순히 현재 파일을 복사해 두는 것과 달리 "어제 상태", "지난주 상태", "수정 전 상태"를 추적할 수 있습니다.
강의 자료로 예를 들어 보겠습니다. 우리가 초보자를 위한 AI 실습.md라는 노트를 고치다가 중요한 설명 문단을 실수로 지웠습니다. 단순 동기화만 되어 있다면 지워진 파일이 모든 기기에 똑같이 반영될 수 있습니다. 하지만 깃허브에 이전 커밋이 남아 있다면, 언제 그 문단이 사라졌는지 비교하고 복구할 가능성이 생깁니다.
그래서 이 책에서 지향하는 방식은 단순한 파일 복사가 아닙니다. 우리는 옵시디언으로 편하게 쓰고, 깃허브로 변경 이력을 남기는 구조를 만들 것입니다.
정리하면 이렇습니다.
동기화는 여러 기기를 현재 상태로 맞추는 일입니다.
백업은 사고가 났을 때를 대비해 사본을 남기는 일입니다.
버전 기록은 과거의 여러 저장 지점을 남겨 되돌아갈 수 있게 하는 일입니다.
초보 단계에서는 "동기화가 되니까 백업도 된 거겠지"라고 생각하지 않는 것이 중요합니다. 동기화는 편리함의 문제이고, 백업과 버전 기록은 복구 가능성의 문제입니다.
클론은 온라인 저장소를 내 컴퓨터로 복사해 오기입니다
앞으로 책을 따라가다 보면 클론Clone이라는 단어도 만날 수 있습니다. 클론은 깃허브에 있는 저장소를 내 컴퓨터로 처음 가져오는 행동입니다.
이미 누군가 만들어 둔 커뮤니티 내부 저장소가 있다고 해 봅시다. 이 저장소를 내가 함께 사용하려면 내 컴퓨터에도 같은 폴더가 있어야 합니다. 이때 클론을 합니다. 그러면 깃허브의 저장소가 내 컴퓨터에 복사되고, 이후부터는 풀과 푸시로 최신 상태를 주고받을 수 있습니다.
비유하자면 클론은 공동 자료실의 기본 서랍장을 내 책상 옆에 하나 가져다 놓는 일입니다. 처음 가져올 때는 클론, 이후 새 자료를 가져올 때는 풀, 내가 수정한 자료를 올릴 때는 푸시라고 이해하면 됩니다.
초보자가 꼭 기억해야 할 흐름은 이렇습니다. 처음 한 번은 클론합니다. 그다음부터는 작업 전에 풀, 작업 후 커밋과 푸시를 반복합니다.
로컬과 원격은 내 컴퓨터와 깃허브의 차이입니다
깃허브를 배우다 보면 로컬Local과 원격Remote이라는 표현도 나옵니다. 이 단어 역시 어렵게 느껴지지만 뜻은 단순합니다.
로컬은 내 컴퓨터입니다. 내가 지금 옵시디언으로 열어 보고 있는 폴더, 내 노트북 안에 있는 파일이 로컬입니다.
원격은 인터넷 너머에 있는 저장소입니다. 이 책에서는 주로 깃허브 저장소를 뜻합니다. 내 컴퓨터가 고장 나도 깃허브 웹사이트에 접속하면 확인할 수 있는 온라인 공간입니다.
그러므로 로컬과 원격의 관계는 "내 책상 위 자료"와 "공동 온라인 자료실"의 관계라고 보면 됩니다. 내 책상에서 자료를 고친 뒤 커밋하고 푸시하면 원격 저장소에 반영됩니다. 원격 저장소에 누군가 새 자료를 올렸다면 풀로 내 책상에 가져옵니다.
이 개념을 이해하면 깃허브의 많은 오류 메시지가 덜 무섭게 느껴집니다. 대부분의 문제는 "내 컴퓨터 상태와 깃허브 상태가 서로 다르다"는 데서 출발합니다. 차이를 맞추는 기본 동작이 풀과 푸시입니다.
초보자가 당장 몰라도 되는 용어들
깃허브를 검색하다 보면 더 많은 단어가 쏟아집니다. 브랜치, 풀 리퀘스트, 머지, 토큰, SSH, 포크, 이슈, 액션 같은 단어들입니다. 이 단어들을 처음부터 모두 이해하려고 하면 금방 지칩니다.
우리의 목표는 개발 프로젝트 운영이 아니라, 강사 커뮤니티의 지식 자료를 안전하게 모으고 공유하는 것입니다. 그러므로 학습 순서가 중요합니다. 지금 당장 필요한 것과 나중에 배워도 되는 것을 나누어야 합니다.
브랜치Branch는 작업을 나누는 별도 길입니다. 원본 자료를 바로 고치지 않고, 복사된 작업 라인에서 수정해 본 뒤 나중에 합칠 때 사용합니다. 초보 단계에서는 하나의 기본 브랜치만 사용해도 충분합니다.
풀 리퀘스트Pull Request는 "제가 이렇게 고쳤는데, 검토한 뒤 합쳐 주세요"라고 요청하는 절차입니다. 여러 사람이 공개 프로젝트를 함께 관리할 때 매우 유용합니다. 하지만 처음에는 GitHub Desktop이나 Obsidian Git으로 단순 백업과 공유에 익숙해지는 것이 먼저입니다.
토큰Token은 깃허브에 로그인하거나 도구를 연결할 때 사용하는 특별한 비밀번호 같은 것입니다. 일반 비밀번호를 직접 넣는 대신 제한된 권한을 가진 토큰을 쓰는 경우가 있습니다. 초보자에게는 설정 과정에서 갑자기 등장해 당황스러울 수 있지만, 처음부터 깊이 이해할 필요는 없습니다. 나중에 도구 연결이 필요할 때 차근차근 다루면 됩니다.
SSH는 내 컴퓨터와 깃허브가 안전하게 통신하도록 연결하는 방식 중 하나입니다. 개발자들은 자주 사용하지만, 입문 단계에서는 GitHub Desktop의 로그인 방식이나 기본 안내를 따라가는 것으로 충분합니다.
이 용어들은 모른다고 부끄러운 것이 아닙니다. 지금은 자동차 운전을 배우는 단계입니다. 엔진 분해, 변속기 구조, 정비 매뉴얼까지 한꺼번에 외울 필요가 없습니다. 먼저 시동을 걸고, 천천히 출발하고, 안전하게 멈추는 법부터 익히면 됩니다.
우리의 첫 학습 순서
이 책에서는 용어를 다음 순서로 몸에 익힐 것입니다. 먼저 옵시디언에서 볼트와 노트, 링크를 이해합니다. 그다음 마크다운으로 강의 노트를 작성합니다. 이후 깃허브에서 저장소를 만들고, 커밋·푸시·풀 흐름을 익힙니다. 마지막으로 공개 자료와 비공개 자료를 나누고, 협업 규칙과 복구 방법까지 확장합니다.
순서를 건너뛰면 어려워집니다. 저장소가 무엇인지 모른 채 브랜치를 배우면 막막합니다. 커밋을 이해하지 못한 채 충돌 해결을 배우면 겁이 납니다. 반대로 기초 용어를 일상 언어로 번역해 두면 이후 과정이 훨씬 편해집니다.
우리 커뮤니티의 입문 순서는 이렇게 잡으면 좋습니다.
1단계: 옵시디언 볼트, 노트, 링크, 마크다운에 익숙해집니다.
2단계: 깃허브 저장소, Public, Private의 차이를 이해합니다.
3단계: 커밋, 푸시, 풀의 기본 흐름을 반복합니다.
4단계: 동기화와 백업의 차이를 알고 복구 감각을 익힙니다.
5단계: 필요할 때 브랜치, 풀 리퀘스트, 토큰, SSH를 배웁니다.
여기서 가장 중요한 것은 3단계입니다. 커밋, 푸시, 풀만 자연스러워져도 깃허브에 대한 두려움이 크게 줄어듭니다. 처음에는 버튼 하나를 누르는 것도 조심스럽겠지만, 몇 번 반복하면 "아, 이건 그냥 작업 흐름이구나" 하고 느끼게 됩니다.
강사 업무로 다시 번역해 보기
이제 핵심 용어를 우리 일상에 맞게 다시 번역해 보겠습니다. 어떤 강사가 AI 입문 강의 후 수강생 질문을 정리한다고 상상해 봅시다.
강사는 옵시디언 볼트를 엽니다. 이것은 자신의 지식 창고 폴더를 여는 일입니다. 그 안에 수강생 질문 모음.md라는 노트를 만듭니다. 이 노트는 마크다운 문서입니다. 질문 중 프롬프트 작성과 관련된 내용은 [[프롬프트 작성법]] 노트로 링크합니다. 이렇게 하면 나중에 프롬프트 강의를 준비할 때 해당 질문을 쉽게 찾아갈 수 있습니다.
며칠 뒤 이 자료를 커뮤니티 내부 저장소에 공유하기로 합니다. 내부 저장소는 구성원끼리만 보는 변경 이력이 남는 온라인 폴더입니다. 자료가 외부에 공개되면 안 되므로 Private 저장소를 사용합니다.
강사는 오늘 정리한 내용을 커밋합니다. 이것은 "수강생 질문 10개 추가"라는 저장 지점을 만드는 일입니다. 그다음 푸시합니다. 이제 깃허브에 올라갔기 때문에 다른 강사들도 볼 수 있습니다.
다음 날 다른 강사가 그 질문에 답변 예시를 추가했습니다. 이제 첫 번째 강사는 작업을 시작하기 전에 풀을 합니다. 깃허브에서 최신 내용을 가져와 내 컴퓨터의 노트를 업데이트하는 것입니다.
이 흐름이 바로 우리가 앞으로 반복할 기본기입니다. 볼트에서 쓰고, 커밋으로 저장 지점을 만들고, 푸시로 올리고, 풀로 최신 내용을 가져옵니다.
용어를 외우지 말고 장면으로 기억하세요
기술 용어는 단어장처럼 외우면 금방 잊힙니다. 대신 장면으로 기억하면 오래갑니다.
볼트는 내 지식 창고 폴더입니다. 노트는 그 안에 들어 있는 마크다운 문서입니다. 링크는 노트 사이를 이어 주는 지름길입니다. 저장소는 변경 이력이 남는 온라인 폴더입니다. Public은 열린 방이고, Private은 초대받은 사람만 들어가는 잠긴 방입니다. 커밋은 저장 지점 만들기입니다. 푸시는 깃허브에 올리기입니다. 풀은 깃허브에서 최신 내용 가져오기입니다.
이 정도만 이해해도 충분합니다. 아직 브랜치나 풀 리퀘스트를 완벽히 몰라도 됩니다. 토큰이나 SSH가 낯설어도 괜찮습니다. 그 단어들은 나중에 실제로 필요해질 때 배우면 됩니다.
지금 우리에게 필요한 것은 두려움을 낮추는 것입니다. 용어가 무섭지 않아야 도구를 열어 볼 수 있고, 도구를 열어 봐야 손이 익고, 손이 익어야 커뮤니티의 지식이 쌓입니다.
다음 장에서는 드디어 옵시디언을 직접 열고 첫 볼트를 만들어 보겠습니다. 이제 볼트라는 단어가 조금 다르게 들릴 것입니다. 그것은 개발자들의 어려운 공간이 아니라, 우리 강의 경험과 인사이트가 자라날 첫 번째 지식 창고입니다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.