한동안 깃허브 블로그를 방치하고 있었어요. "언젠가 다시 정리해야지"라는 생각만 반복하다가, 공부한 내용을 제대로 기록하고 공유할 공간이 필요하다는 걸 느꼈어요. 그래서 블로그를 처음부터 다시 만들기로 했어요. 왜 Next.js를 선택했을까 당시 스벨트가 떠오르고 있었지만, 블로그를 빠르게 완성하려면 Next.js가 낫겠다고 판단했어요. 스벨트를 새로 배우고 스벨트킷을 익히면서 적합한 라이브러리를 찾아가는 것보다, Next.js 하나만 학습하면서 진행하는 게 러닝커브가 훨씬 짧았거든요. 기존 블로그가 Next.js 12 버전이었는데, npx로 업그레이드를 시도하니 이상하게 잘 되지 않았어요. 결국 새 프로젝트를 생성하고 shadcn을 적용하는 방식으로 진행했어요. 지금은 Next.js 14 + Contentlayer 조합으로 정적 블로그를 운영하고 있어요. 개발 환경 세팅 당시 사용하던 iMac에는 노드가 설치되어 있지 않았기 때문에 Next.js의 Docker 예제를 활용했어요. 패키지 매니저는 pnpm을 사용하기로 했고, Homebrew로 설치하면 간단해요. pnpm create next-app --example with-docker nextjs-docker 이 한 줄로 Docker 기반의 Next.js 프로젝트가 생성돼요. 블로그에 필요한 기능들 블로그에 어떤 기능이 필요한지 정리해봤어요. Next.js 자체 기능과 외부 라이브러리를 조합하면 대부분 구현할 수 있어요. Routing — Next.js App Router로 페이지 간 이동 처리 이미지 렌더링 — 마크다운 속 외부 이미지를 data URI로 최적화 댓글 기능 — 깃허브 기반 댓글 시스템 활용 블로그 화면 구성 현재 블로그는 이런 구조로 되어 있어요. 화면 역할 Home 최신 글 소개, 검색, 게시글 목록 Books 읽은 책 목록과 상세 보기 Tags 태그별로 글을 조회 About 자기소개 Home이 게시글 목록과 검색 기능을 모두 담당하고 있어서, 별도의 Posts 페이지 없이도 충분해요. Books 화면에서는 읽은 책 중 가장 감명 깊었던 구절을 하단에 넣기로 했어요. 마크다운을 HTML로 변환하기 블로그 글을 화면에 보여주려면 마크다운 파일을 HTML로 변환해야 해요. 지금은 Contentlayer가 이 역할을 맡고 있지만, 처음에는 직접 변환 파이프라인을 구성했었어요. generateStaticParams에서 posts 폴더의 모든 게시글을 가져와서 하나씩 읽고, unified로 마크다운을 HTML로 변환하고, frontmatter에서 메타데이터를 추출해서 Post 객체를 만드는 방식이었어요. 마크다운 변환에 많이 쓰이는 도구를 비교해봤어요. 라이브러리 특징 gray-matter frontmatter 파싱에 특화 marked 깃허브 별이 많고 10년 이상 된 검증된 라이브러리 unified 플러그인 생태계가 풍부해서 확장성이 뛰어남 결국 확장성을 우선해서 unified 계열을 선택했어요. 지금도 Contentlayer 내부에서 remark/rehype 플러그인을 조합해 구문 강조, 수식 렌더링, 외부 링크 처리 등을 하고 있어요. unified 패키지를 사용할 때 이 글(일본어)이 도움이 많이 됐어요. 마인드맵으로 학습 여정 시각화하기 블로그를 만들면서 한 가지 아이디어가 더 떠올랐어요. 공부에 의미를 부여하면 기억이 잘 된다는 이야기에서 영감을 받았거든요. 각 태그를 마인드맵으로 볼 수 있는 화면을 만들면 어떨까 싶었어요. 공부해서 블로그에 올린 내용들을 점으로 만들고, 그 점들을 선으로 잇는 거예요. 예를 들어 도커를 공부했다면, 도커가 뭔지 감이 잡히는 과정에서 나는 어떤 시각으로 도커를 바라보게 됐는지, 그리고 이 다음에는 어떤 공부를 하게 될지를 시각적으로 추적할 수 있어요. 이 연결을 눈으로 볼 수 있다면 그 자체로 동기부여가 돼요. 돌아보며 블로그를 다시 만드는 건 단순히 기술 스택을 바꾸는 게 아니었어요. 공부한 것을 정리하고, 그 과정을 다른 사람과 나누는 하나의 시스템을 만드는 일이었죠. 완벽한 블로그를 기다리기보다, 일단 만들고 하나씩 개선해나가는 게 가장 좋은 시작이에요. No man can succeed in a line of endeavor which he does not like.— Napoleon Hill

요즘 SNS에 짧은 영상 하나 올리는 게 글 하나 쓰는 것보다 반응이 좋을 때가 많죠. 그런데 막상 영상 편집을 하려면 어디서부터 시작해야 할지 막막해요. CapCut은 무료이면서도 기능이 꽤 강력해서, 처음 시작하기에 딱 좋은 앱이에요. 이 글에서는 캡컷으로 영상을 편집하고 SNS에 올리는 과정을 정리해볼게요. 시작하기: 설치와 프로젝트 생성 CapCut은 App Store와 Google Play에서 무료로 다운로드할 수 있어요. 앱을 열고 '새 프로젝트' 를 누르면 갤러리에서 영상을 골라 타임라인에 바로 넣을 수 있어요. 기본적인 편집 흐름은 이렇게 생각하면 돼요. 영상 자르기 — 타임라인에서 원하는 위치를 탭하고 '분할' 버튼을 누르면 끝이에요 자막 넣기 — '텍스트 추가'로 직접 입력하거나, 자동 자막 기능(한국어 지원)을 쓰면 편해요 음악 추가 — 캡컷 내장 음원 라이브러리에서 분위기에 맞는 배경음악을 골라보세요 효과와 전환 — 장면 사이에 전환 효과를 넣으면 영상이 훨씬 자연스러워져요 내보내기 전에 틱톡 워터마크 해제를 확인하세요. 설정에서 꺼두면 다른 플랫폼에 올릴 때 깔끔해요. 촬영할 때 미리 챙기면 좋은 것들 편집도 중요하지만, 촬영 단계에서 조금만 신경 쓰면 후작업이 훨씬 수월해져요. 세로 9:16 비율로 촬영하세요. 릴스와 쇼츠 모두 세로 영상이 기본이에요 자연광을 활용하면 별도 조명 없이도 화면이 밝고 깨끗해요 촬영 전에 간단한 스크립트를 짜두면 30분 안에 편집까지 끝낼 수 있어요 스크립트는 이 세 가지 구조로 생각하면 쉬워요. 훅 (첫 3초) — 시선을 끄는 장면이나 질문으로 시작 하이라이트 — 전달하고 싶은 핵심 내용 CTA — "구독", "좋아요", "다음 영상에서 계속" 같은 행동 유도 첫 3초가 정말 중요해요. 스크롤을 멈추게 만드는 임팩트 있는 장면을 앞에 배치하세요. 사운드 믹싱: 소리의 균형 잡기 영상에서 소리 밸런스는 생각보다 중요해요. 음악이 너무 크면 목소리가 묻히고, 너무 작으면 영상이 밋밋해지거든요. 기본 원칙은 음성을 기준으로 다른 소리를 낮추는 것이에요. 먼저 음성 피크를 -12 ~ -6 dB로 맞춘 뒤, 나머지를 상대적으로 조절하면 돼요. 요소 음성 기준 상대 dB 절대 dB 예시 팁 음성(대화) 0 dB (기준) -12 ~ -6 dB 먼저 노멀라이즈 주요 효과음 -3 ~ -6 dB -12 ~ -15 dB 강조하되 약간 낮춤 배경 효과음 -6 ~ -10 dB -15 ~ -18 dB 자연스러운 배경 수준 배경음악 -10 ~ -18 dB -18 ~ -27 dB 덕킹으로 자동 조절 타임라인에서 볼륨 슬라이더나 키프레임으로 세밀하게 조절할 수 있어요. Pro 버전의 오디오 덕킹 기능을 쓰면 음성이 나올 때 배경음악이 자동으로 줄어들어서 편리해요. SNS에 올리기 인스타그램 릴스 인스타 앱에서 '+' 버튼 → '릴스' 를 선택하고 캡컷에서 만든 영상을 불러오면 돼요. 인스타 내에서 음악이나 스티커를 추가로 넣을 수도 있어요. 해시태그는 콘텐츠와 관련된 키워드를 3~5개 정도 넣는 게 적당해요. 캡컷 로고가 영상에 남아 있다면 인스타 편집 화면에서 크롭으로 잘라낼 수 있어요. 틱톡 캡컷은 원래 틱톡을 만든 바이트댄스의 앱이라서, 틱톡과의 연동이 가장 매끄러워요. 캡컷 편집 화면에서 '틱톡으로 공유' 버튼을 누르면 별도 내보내기 없이 바로 업로드할 수 있어요. 틱톡에서는 트렌딩 사운드를 활용하는 게 노출에 유리해요. 캡컷에서 기본 편집을 마친 뒤, 틱톡 앱 내에서 인기 음원으로 교체하는 방법도 괜찮아요. 해시태그는 트렌딩 태그와 콘텐츠 관련 태그를 섞어서 5~8개 정도 넣어보세요. 유튜브 쇼츠 유튜브 앱에서 '+' 버튼 → '쇼츠 만들기' 를 눌러 영상을 업로드하세요. 세로 영상은 자동으로 쇼츠로 인식돼요. 제목은 15~30자 정도가 적당하고, 저작권에 안전한 음원을 사용하는 게 중요해요. 캡컷 내장 음원은 대부분 상업적 사용이 가능하지만, 업로드 전에 한 번 확인해보세요. 꾸준함이 핵심이에요 처음에는 하나 만드는 데 시간이 오래 걸려도 괜찮아요. 주 2~3회 정도 꾸준히 올리다 보면 편집 속도도 빨라지고, 자연스럽게 구독자도 쌓여요. 완벽한 영상을 기다리기보다, 지금 가진 영상으로 릴스 하나 만들어보는 게 가장 좋은 시작이에요. Argue for your limitations, and sure enough they're yours.— Richard Bach

Java에서 코틀린으로 넘어오는 서비스들이 많죠. 코틀린을 보면 가장 먼저 느낀 건 간결함이었어요. 자바에 비해 같은 로직을 절반도 안 되는 코드로 표현할 수 있다는 게 꽤 신선했거든요. 이 글에서는 실무에서 자주 쓰는 코틀린 문법을 정리해볼게요. Null Safety부터 코루틴까지, 핵심만 다뤄봐요. 변수와 타입 추론 코틀린의 변수 선언은 두 가지예요. val은 불변, var는 가변이에요. val name: String = "홍길동" val age = 30 // 타입 추론으로 Int var count: Int = 0 count = 1 const val MAX_SIZE = 100 // 컴파일 타임 상수 Java에서 final을 매번 붙이던 것과 달리, 코틀린에서는 val이 기본이라 자연스럽게 불변을 지향하게 돼요. 문자열 처리도 훨씬 깔끔해요. 문자열 템플릿과 raw string을 쓰면 StringBuilder를 꺼낼 일이 거의 없어요. val json = """ { "name": "$name", "age": $age } """.trimIndent() Null Safety 코틀린을 쓰는 가장 큰 이유 중 하나예요. 모든 타입이 기본적으로 non-null이기 때문에 NullPointerException을 컴파일 타임에 잡아줘요. var nickname: String? = null // ?를 붙여야 null 허용 nickname?.length // Safe call: null이면 null 반환 nickname!!.length // Non-null assertion: null이면 크래시 val len = nickname?.length ?: 0 // Elvis 연산자: null일 때 기본값 실무에서는 let과 Elvis 연산자를 조합하는 패턴을 가장 많이 써요. nickname?.let { println("닉네임: $it") } fun process(name: String?) { val n = name ?: return // null이면 조기 반환 println(n.uppercase()) } !! 연산자는 테스트 코드 외에는 쓰지 않는 게 좋아요. 결국 NPE를 다시 만들어내는 것과 같거든요. 함수와 확장함수 기본값과 명명 인자 덕분에 Java에서 오버로딩으로 해결하던 문제가 함수 하나로 끝나요. fun greet(name: String = "Guest", age: Int = 0) = "Hello, $name ($age세)" greet(age = 30, name = "홍길동") // 순서 무시 가능 확장함수는 기존 클래스를 수정하지 않고 메서드를 추가하는 기능이에요. 유틸리티 함수를 만들 때 특히 유용해요. fun String.toSlug() = this.lowercase().replace(" ", "-").replace(Regex("[^a-z0-9-]"), "") "Hello World".toSlug() // "hello-world" 클래스: Data Class와 Sealed Class Data Class DTO나 모델 객체를 만들 때 equals(), hashCode(), toString(), copy()를 자동 생성해줘요. Java의 boilerplate를 완전히 없앨 수 있어요. data class User( val id: Long, val name: String, val email: String ) val user2 = user1.copy(name = "김철수") // 일부 필드만 변경한 복사본 Sealed Class 상태 관리에 특화된 클래스예요. when 표현식과 함께 쓰면 모든 경우를 컴파일러가 체크해주기 때문에 else 분기가 필요 없어요. sealed class Result&x3C;out T> { data class Success&x3C;T>(val data: T) : Result&x3C;T>() data class Error(val message: String) : Result&x3C;Nothing>() object Loading : Result&x3C;Nothing>() } fun handleResult(result: Result&x3C;String>) = when (result) { is Result.Success -> "성공: ${result.data}" is Result.Error -> "에러: ${result.message}" Result.Loading -> "로딩 중..." } 새로운 상태를 추가하면 when을 쓰는 모든 곳에서 컴파일 에러가 발생하므로, 누락 없이 처리할 수 있어요. 제어문은 표현식 코틀린에서는 if와 when 모두 값을 반환하는 표현식이에요. val max = if (a > b) a else b val message = when (status) { "PENDING" -> "대기중" "CONFIRMED" -> "확정" in listOf("CANCELLED", "FAILED") -> "실패" else -> "알수없음" } Java의 삼항 연산자(? :)가 없는 대신 if 자체가 그 역할을 해요. when은 switch보다 훨씬 유연해서, 범위 검사나 타입 검사도 가능하고요. 컬렉션 함수형 처리 코틀린의 컬렉션 API는 Java의 Stream보다 간결해요. val numbers = listOf(1, 2, 3, 4, 5) numbers.filter { it > 2 } // [3, 4, 5] numbers.map { it * 2 } // [2, 4, 6, 8, 10] numbers.groupBy { it % 2 == 0 } // {false=[1,3,5], true=[2,4]} numbers.chunked(2) // [[1,2], [3,4], [5]] .stream().collect(Collectors.toList()) 같은 코드를 안 써도 돼요. 스코프 함수 다섯 가지 스코프 함수는 처음엔 헷갈리지만, 핵심은 참조 방식(it vs this)과 반환값(람다 결과 vs 객체 자체)의 조합이에요. 함수 참조 반환 용도 let it 람다 결과 null 체크, 변환 run this 람다 결과 설정 후 계산 with this 람다 결과 여러 메서드 호출 apply this 객체 자체 객체 초기화 also it 객체 자체 로깅, 부가 작업 실무에서 가장 많이 쓰는 조합은 apply + also예요. val user = User().apply { name = "홍길동" age = 30 }.also { log("유저 생성: $it") } apply로 객체를 초기화하고, also로 사이드 이펙트(로깅 등)를 처리하는 패턴이에요. 코루틴 코틀린의 비동기 처리는 코루틴이 담당해요. RxJava보다 학습 곡선이 낮고, 코드가 동기식처럼 읽혀요. 기본 API 호출 viewModelScope.launch { _loading.value = true _user.value = repository.getUser(id) _loading.value = false } 병렬 호출 순차 실행이면 3초 걸리는 작업을, async로 병렬 처리하면 1초로 줄일 수 있어요. coroutineScope { val user = async { fetchUser() } val posts = async { fetchPosts() } val comments = async { fetchComments() } Triple(user.await(), posts.await(), comments.await()) } Dispatcher로 스레드 전환 viewModelScope.launch { showLoading() // Main 스레드 val user = withContext(Dispatchers.IO) { api.getUser(id) // IO 스레드 } showUser(user) // 다시 Main 스레드 } withContext로 스레드를 전환해도 콜백 지옥 없이 위에서 아래로 읽을 수 있어요. Java 상호운용 기존 Java 코드와의 호환이 필요하다면 @JvmStatic, @JvmField 같은 어노테이션을 활용하면 돼요. class Utils { companion object { @JvmStatic fun helper() { } } } // Java에서 Utils.helper()로 호출 가능 정리 코틀린은 결국 안전하고 간결한 코드를 지향하는 언어예요. 이 글에서 다룬 내용 중 실무에서 가장 체감이 큰 건 다음 세 가지였어요. Null Safety - 런타임 크래시를 컴파일 타임으로 끌어올려줘요 Sealed Class + when - 상태 누락 없는 분기 처리가 가능해요 코루틴 - 콜백 없이 비동기 코드를 작성할 수 있어요 더 깊이 파고 싶다면 Kotlin Koans로 연습해보세요. We learn what we have said from those who listen to our speaking.— Kenneth Patton