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

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로 확인합니다. 링크가 출력되면 성공입니다.

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보다 전체 경로가 더 안전합니다.

4. 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을 추가하지 마세요.

• 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 오류를 참고하세요.