Cómo subir imágenes de Typora a S3 o Cloudflare R2

El cargador personalizado de Typora ejecuta un comando con las rutas de las imágenes y lee los enlaces que muestra. aktar hace justo eso, con los destinos que ya configuraste en Aktar para Mac o Windows.

brew install getaktar/tap/aktar-cli    # or: npm install -g @getaktar/cli

1. En Aktar, abre Ajustes → Integraciones, activa Permitir conexiones locales y copia el token.
2. Ejecuta aktar login en una terminal y pégalo.
3. Compruébalo con aktar upload some-image.png. Debería mostrar un enlace.

1. Abre los ajustes de Typora (Typora > Settings… en un Mac, File > Preferences… en Windows) y ve a Image.
2. En Image Uploader, elige Custom Command.
3. Introduce el comando con su ruta completa. En un Mac con Homebrew es:

/opt/homebrew/bin/aktar upload

Ejecuta which aktar (en Windows, where aktar) para ver dónde está el tuyo. Typora no siempre ve el PATH de tu terminal, por eso la ruta completa es más segura que escribir solo aktar.

4. Haz clic en Test Uploader. Typora sube dos pequeñas imágenes de prueba y muestra los enlaces que ha recibido.

En los mismos ajustes de Image, configura When Insert… en Upload Image. A partir de ahí, al pegar o arrastrar una imagen a un documento, se sube y el enlace del bucket se escribe en el Markdown.

Para un documento que ya tiene imágenes locales, usa Format > Image > Upload All Local Images.

De forma predeterminada, las imágenes van al destino seleccionado en la barra de menús de Aktar, con el nombre que marca su plantilla de ruta. Para enviar las imágenes de Typora a otro sitio, añade opciones al comando:

/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

Deja la salida como URL simples (la opción predeterminada): Typora escribe el Markdown por su cuenta, así que no añadas --format ni --json aquí.

• No se encuentra el comando o no se encuentra node: usa la ruta completa que muestra which aktar. La versión de Homebrew incluye su propia ruta a Node, así que funciona desde Typora tal cual; si la instalaste con npm, ejecútala como /path/to/node /path/to/aktar upload.
• No hay conexión con Aktar: ejecuta aktar login en una terminal y asegúrate de que Aktar está abierto y con Permitir conexiones locales activado.
• El enlace se abre con Access Denied: la subida funcionó, pero el bucket no es público en su URL pública. Consulta errores Access Denied.