Typora는 기본적으로 붙여 넣은 이미지를 Markdown 파일 옆에 저장합니다. 문서를 게시하거나, GitHub에 붙여 넣거나, 다른 사람에게 보내기 전까지는 괜찮습니다. 그때부터 이미지는 내 컴퓨터에 남겨집니다. 글을 쓰는 동안 이미지를 내 버킷에 업로드하면 Markdown을 어디로든 옮길 수 있고, 링크는 내가 관리하는 스토리지를 가리킵니다.
aktar 명령어 설치하고 연결하기
Typora의 사용자 지정 업로더는 이미지 경로를 인수로 명령어를 실행하고, 출력된 링크를 읽습니다. aktar가 바로 그 일을 하며, Mac 또는 Windows용 Aktar에 이미 설정한 대상을 사용합니다.
brew install getaktar/tap/aktar-cli # or: npm install -g @getaktar/cli
- Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켠 다음 토큰을 복사합니다.
- 터미널에서
aktar login을 실행하고 토큰을 붙여 넣습니다. aktar upload some-image.png로 확인합니다. 링크가 출력되면 성공입니다.
aktar를 Typora의 이미지 업로더로 설정하기
- Typora 설정(Mac에서는 Typora > Settings…, Windows에서는 File > Preferences…)을 열고 Image로 이동합니다.
- Image Uploader에서 Custom Command를 선택합니다.
- 명령어를 전체 경로로 입력합니다. Homebrew를 쓰는 Mac에서는 다음과 같습니다.
/opt/homebrew/bin/aktar upload
내 경로는 which aktar(Windows에서는 where aktar)로 확인하세요. Typora가 터미널의 PATH를 항상 인식하지는 못하므로, 그냥 aktar보다 전체 경로가 더 안전합니다.
- 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에서도 작동하나요?
PicGo나 플러그인이 필요한가요?
업로드한 이미지를 만료시킬 수 있나요?
--expires 30을 추가하면 30일 후 버킷이 이미지를 삭제합니다. 다만 게시하는 문서의 이미지라면 대개 남겨 두는 편이 좋습니다.