• 알아보기
  • 2026년 9월 30일
  • 4분 분량

Typora 이미지를 S3나 Cloudflare R2에 업로드하는 방법

Typora는 기본적으로 붙여 넣은 이미지를 Markdown 파일 옆에 저장합니다. 문서를 게시하거나, GitHub에 붙여 넣거나, 다른 사람에게 보내기 전까지는 괜찮습니다. 그때부터 이미지는 내 컴퓨터에 남겨집니다. 글을 쓰는 동안 이미지를 내 버킷에 업로드하면 Markdown을 어디로든 옮길 수 있고, 링크는 내가 관리하는 스토리지를 가리킵니다.

aktar 명령어 설치하고 연결하기

Typora의 사용자 지정 업로더는 이미지 경로를 인수로 명령어를 실행하고, 출력된 링크를 읽습니다. aktar가 바로 그 일을 하며, Mac 또는 Windows용 Aktar에 이미 설정한 대상을 사용합니다.

brew install getaktar/tap/aktar-cli    # or: npm install -g @getaktar/cli
  1. Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사합니다.
  2. 터미널에서 aktar login을 실행하고 토큰을 붙여 넣습니다.
  3. aktar upload some-image.png로 확인합니다. 링크가 출력되면 성공입니다.

aktar를 Typora의 이미지 업로더로 설정하기

  1. Typora 설정(Mac에서는 Typora > Settings…, Windows에서는 File > Preferences…)을 열고 Image로 이동합니다.
  2. Image Uploader에서 Custom Command를 선택합니다.
  3. 명령어를 전체 경로로 입력합니다. Homebrew를 쓰는 Mac에서는 다음과 같습니다.
/opt/homebrew/bin/aktar upload

내 경로는 which aktar(Windows에서는 where aktar)로 확인하세요. Typora가 터미널의 PATH를 항상 인식하지는 못하므로, 그냥 aktar보다 전체 경로가 더 안전합니다.

  1. Test Uploader를 클릭합니다. Typora가 작은 테스트 이미지 두 장을 업로드하고 받은 링크를 보여 줍니다.

붙여 넣을 때 이미지 자동 업로드하기

같은 Image 설정에서 When Insert…를 Upload Image로 설정하세요. 이제 문서에 이미지를 붙여 넣거나 끌어다 놓으면 업로드되고 버킷 링크가 Markdown에 기록됩니다.

로컬 이미지가 이미 있는 문서에는 Format > Image > Upload All Local Images를 사용하세요.

이미지를 보낼 곳 정하기

기본적으로 이미지는 Aktar 메뉴 막대에서 선택한 대상으로 업로드되며, 그 대상의 경로 템플릿에 따라 이름이 정해집니다. Typora 이미지를 다른 곳으로 보내려면 명령어에 옵션을 추가하세요.

/opt/homebrew/bin/aktar upload -d Blog              # a destination named "Blog"
/opt/homebrew/bin/aktar upload --folder docs/images # keep file names, in one folder

출력은 일반 URL(기본값)로 유지하세요. Markdown은 Typora가 직접 작성하므로 여기에는 --format이나 --json을 추가하지 마세요.

Test Uploader가 실패한다면

  • command not found 또는 node not found: which aktar로 확인한 전체 경로를 사용하세요. Homebrew 버전은 Node 경로를 자체적으로 포함하므로 Typora에서 그대로 작동합니다. npm으로 설치했다면 /path/to/node /path/to/aktar upload 형태로 실행하세요.
  • Aktar에 연결되지 않음: 터미널에서 aktar login을 실행하고, Aktar가 로컬 연결 허용을 켠 상태로 실행 중인지 확인하세요.
  • 링크를 열면 Access Denied가 표시됨: 업로드는 성공했지만 버킷이 공개 URL에서 공개되지 않은 상태입니다. Access Denied 오류를 참고하세요.

Aktar에 맡기는 방법도 있습니다

스토리지 키를 보관하고 업로드를 수행하는 것은 Aktar이고, aktar는 이미지를 넘겨줄 뿐이므로 Typora에 키를 줄 필요가 없습니다. 같은 버킷을 메뉴 막대, 전역 단축키, Raycast, 휴대폰에서도 쓸 수 있으며, 모든 이미지가 Aktar 기록에 표시됩니다.

스크린샷을 링크로

자주 묻는 질문

Cloudflare R2, Backblaze B2, MinIO에서도 작동하나요?

네. aktar는 Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO 등 Aktar에 설정된 모든 대상으로 업로드합니다. 설정 가이드를 참고하세요.

PicGo나 플러그인이 필요한가요?

아니요. Typora에 내장된 Custom Command 옵션이 aktar를 직접 실행합니다.

업로드한 이미지를 만료시킬 수 있나요?

네. 명령어에 --expires 30을 추가하면 30일 후 버킷이 이미지를 삭제합니다. 다만 게시하는 문서의 이미지라면 대개 남겨 두는 편이 좋습니다.