Guía de uso de Docki

Docki es una app de repetición espaciada: cada mazo tiene un Document (el Documento, es decir, la lección) y Flashcards (tarjetas) para recordarla. La IA redacta tarjetas y cuestionarios a partir del Documento, y el planificador FSRS trae cada tarjeta de vuelta justo antes de que la olvides. Esta guía recorre todas las partes de la app. Los nombres en negrita son los de los botones y menús de la app, que aparecen en inglés.

En esta página
  1. Primeros pasos
  2. Mazos y carpetas
  3. Documentos
  4. Tarjetas
  5. Mazos de vocabulario
  6. Estudiar
  7. Cuestionarios
  8. Explorar y buscar
  9. Importar, copia de seguridad y sincronización
  10. Estadísticas
  11. Ajustes
  12. Atajos y gestos
  13. Avisar de un problema
  14. Solución de problemas

Primeros pasos

  1. Crea una cuenta con tu correo y una contraseña (de al menos 8 caracteres). Tus mazos se guardan en esta cuenta, así que puedes iniciar sesión desde cualquier navegador o dispositivo.
  2. Sigue la lista Getting Started: las cuentas nuevas ven en Today una lista interactiva con los pasos básicos (elegir una plantilla inicial, leer unas notas de ejemplo, repasar tus primeras 5 tarjetas). Registra tu progreso y puedes ocultarla o volver a abrirla cuando quieras desde Settings.
  3. Crea un mazo: en la barra lateral elige New Deck (una cuenta nueva empieza con un mazo vacío, con una pantalla de inicio para escribir Markdown, subir un archivo PDF o Word o añadir una plantilla inicial). Un mazo contiene los dos tipos de tarjeta: Knowledge (pregunta y respuesta) y Word (una palabra o frase de un idioma), cada una en su propia pestaña de la vista Flashcards. O Importa un mazo de Anki que ya tengas.
  4. Añade algo que aprender: escribe o pega la lección en el Document del mazo y deja que la IA genere tarjetas, o escríbelas tú.
  5. Repasa un poco cada día: abre Today y pulsa Start Review (o Space).

Orientarse en la app

  • Barra lateral — Decks Tree: tus carpetas y mazos. Junto a cada uno hay tres números: las tarjetas New (nuevas), en Learning (aprendizaje) y Due (pendientes) hoy. El botón Pin alterna entre Pinned (fija, empuja el contenido de la página) y Floating (flotante, se cierra sola al hacer clic fuera).
  • Barra superior: Decks (Today), Browse, Stats, Sync, además de Create Card, la lista de atajos, Settings y el menú de tu cuenta.
  • Today: lo que toca repasar en tus mazos, tus mazos recientes y pestañas para los mazos Knowledge y Vocab.
  • En el móvil: las secciones van en una fila bajo la cabecera, y Today muestra tu Decks Tree, los mazos Recent y Tags. Todo lo demás funciona igual.

Mazos y carpetas

  • Deck y Folder están al final de la barra lateral. Las carpetas pueden contener mazos y subcarpetas; arrastra un mazo o carpeta para moverlo.
  • Haz clic derecho en un mazo o carpeta (o usa su botón ⋯) para Study now, Rename, Duplicate, Deck settings…, crear mazos nuevos dentro de una carpeta y Delete. Haz doble clic en un nombre (o pulsa F2) para renombrarlo.
  • Al abrir una carpeta ves sus mazos y puedes estudiarlos todos a la vez.
  • Un mazo tiene dos pestañas: Document y Flashcards. Study inicia un repaso solo de ese mazo.

Borrar un mazo elimina su Documento, sus tarjetas y su historial de repasos. Exporta antes una copia de seguridad (ver Importar, copia de seguridad y sincronización) si es posible que quieras recuperarlo.

Documentos

El Documento es la lección que hay detrás de un mazo. De él se generan las tarjetas y los cuestionarios, y cada tarjeta generada recuerda la sección de la que procede.

  • Pestañas del Documento y navegación fija: organiza las lecciones en varias pestañas de Markdown o PDF. Al desplazarte por notas largas o al editar, la barra de pestañas y las herramientas se quedan fijas arriba para que nunca pierdas el sitio.
  • Edit (E) abre el editor. Entiende Markdown: títulos, negrita, listas, tablas, código, enlaces, imágenes y diagramas Mermaid. Guarda con Ctrl+S.
  • Selecciona cualquier texto para abrir un menú: Explain in detail, Give illustrative examples o Simplify (la IA responde junto al texto; arrastra el encabezado para moverla y la esquina inferior derecha para cambiar su tamaño), Ask AI about this… (tu propia pregunta sobre ese texto), Create new Flashcard (Ctrl+N / ⌘N donde el navegador lo permita), Generate quiz (un cuestionario breve solo sobre esa parte), Read aloud y Copy excerpt. El mismo menú aparece en el texto de una tarjeta mientras repasas.
  • Add to Document: tanto en las ventanas de IA al seleccionar texto como en el chat de Ask AI, pulsa Add to Document para insertar la explicación directamente en tus notas como un recuadro con formato, con el pasaje citado y su contexto.
  • Ask AI abre un chat sobre el Documento. Las preguntas siguientes mantienen el contexto de la conversación, y una respuesta de Explain / Simplify / Example puede continuar allí con Ask follow-up. Toca el micrófono para decir tu pregunta: se convierte en texto que puedes revisar antes de enviar. Cada respuesta se puede copiar, añadir al documento o convertir en una Flashcard. La conversación se guarda en este navegador; New chat empieza de cero.
  • Export: exporta cualquier pestaña del Documento a Markdown (.md), Word (.doc), PDF (.pdf) o una copia completa del mazo, Deck backup (.json), con un diseño limpio y el formato conservado.
  • Edit with AI aparece junto al texto que seleccionas en el editor del Documento (en el móvil, sobre el teclado) y lo reescribe: conviértelo en un diagrama o una tabla, haz viñetas, reescríbelo con más claridad, añade un ejemplo, corrige la ortografía, o describe tu propio cambio. Ves el resultado antes de que sustituya nada.
  • Beautify (en el editor) hace que toda la página sea más fácil de leer: primero ordena el Markdown (sintaxis de títulos, líneas en blanco y marcadores de lista) y luego añade saltos de párrafo donde cambia la idea, pone en negrita los términos clave y escribe los términos extranjeros o técnicos y los ejemplos en cursiva. Eliges cuáles de las tres cosas hacer y cuánto énfasis (Light, Balanced o Rich). Tus palabras nunca cambian —la app rechaza cualquier resultado que las cambie— y el código, las tablas y las imágenes se dejan intactos. La vista previa muestra el resultado al instante; Undo (o Ctrl+Z) recupera la página anterior.
  • Analyze muestra Knowledge Coverage: los conceptos del Documento y cuáles aún no tienen tarjeta. Generate Missing Flashcards rellena los huecos.

Los títulos (## Concepto) y los términos clave en negrita ayudan a la IA y a Knowledge Coverage a encontrar los conceptos de tu Documento.

Tarjetas

Escribir tarjetas

  • Create Card (A) abre el editor de tarjetas: un Front (la pregunta), un Back (la respuesta), el mazo y las etiquetas.
  • Ambas caras admiten formato, listas, código, imágenes, audio, vídeo y diagramas. Para añadir una foto, súbela, pégala o suéltala, búscala o pega el enlace de una imagen.
  • Añade una typed answer (respuesta escrita) para practicar escribiendo la respuesta: durante el repaso la escribes y ves qué has acertado, letra por letra.
  • Source vincula la tarjeta con un pasaje del Documento, para que puedas volver al contexto mientras estudias.

Generar tarjetas con IA

En la pestaña Document elige Generate Flashcards (o Generate with AI en la pestaña Flashcards). Selecciona antes el texto si solo quieres usar esa parte del Documento. Después elige:

  • Un estilo: One card per item, Vocabulary, Q&A, Fill in the blank o Reverse, o escribe tus propias Instructions.
  • El Number of Cards (número de tarjetas) y la Difficulty (dificultad: fácil, media, difícil).

Revisas los borradores antes de añadirlos: edita cualquier tarjeta, quita las que no quieras y añade el resto al mazo.

Si el servidor no tiene clave de IA, las funciones de IA siguen funcionando con unas reglas sencillas integradas: útiles para probar la app, pero con resultados mucho más básicos. Settings → AI muestra cuál estás usando.

Mazos de vocabulario

Las tarjetas Word convierten una lista de palabras en tarjetas completas: una foto, el significado, la pronunciación (IPA) con audio, una frase de ejemplo y su traducción, todo rellenado por ti y editable después.

  1. En Deck settings… marca This deck is for learning a language y elige el Language you are learning y el idioma de los Meanings and translations (si no, las palabras usan inglés → vietnamita).
  2. Elige Generate Flashcards, escribe las palabras una por línea —o usa Find words in the Document para sacarlas de un texto—, elige la voz del audio (cada voz muestra su precio y cuántos caracteres leerá) y genera.
  3. Activa Play the card’s audio when each side shows en Deck settings para oír cada palabra al aparecer. Pulsa R en el repaso para repetirla —o toca el botón de reproducir de un sonido— y vuelve a pulsar en unos segundos para oírla despacio (aparece una tortuga); otra vez recupera la velocidad normal.

¿Has encontrado una palabra nueva leyendo un Documento o repasando una tarjeta? Selecciónala y elige Add as a word, y la tarjeta completa se crea en ese mismo mazo.

Las listas largas pueden tardar hasta un minuto. Cualquier paquete de Anki también se puede importar como tarjetas de palabras.

Estudiar

Start Review en Today estudia todo lo pendiente; Study en un mazo o carpeta estudia solo eso. Cada tarjeta muestra primero su pregunta: intenta recordar la respuesta, luego descúbrela (Space) y califícate con sinceridad:

BotónTeclaCuándo usarlo
Again1No lo recordaste. La tarjeta vuelve pronto.
Hard2Lo recordaste, con verdadero esfuerzo.
Good3Lo recordaste con normalidad. La opción habitual.
Easy4Al instante y sin esfuerzo. La tarjeta espera mucho más.

El planificador FSRS usa tus calificaciones para calcular cuánto sabes cada tarjeta y cuándo estás a punto de olvidarla. Cada botón muestra cuándo volverá la tarjeta. Unos minutos al día bastan; cuando no queda nada pendiente verás All caught up for today.

Durante el repaso

  • Undo (Ctrl+Z) deshace la última respuesta; E edita la tarjeta actual; H abre su pista. Una tarjeta Knowledge sin pista propia tiene un botón AI hint (o H): la IA lee la pregunta y la respuesta y da un empujón sin revelar la respuesta; usa tu cupo de IA.
  • V lee la tarjeta en voz alta (o solo el texto que seleccionaste); ← → se mueven entre las partes mientras lee.
  • Ask AI (el botón de bocadillo) conversa sobre la tarjeta actual, por escrito o con la voz. Antes de mostrar la respuesta da pistas en lugar de la respuesta; cada tarjeta guarda su propia conversación.
  • En el móvil, desliza la tarjeta o toca dos veces para responder (ver Atajos y gestos), y usa Focus para mostrar solo la tarjeta y tu progreso.
  • Esc sale del repaso. Tu progreso se guarda después de cada tarjeta.

Cuestionarios

Un cuestionario comprueba una lección entera de una vez. Elige Generate Quiz en la pestaña Document (o Quiz sobre el texto seleccionado), escoge el número de preguntas y la dificultad, y responde preguntas de opción múltiple, verdadero/falso, rellenar huecos y respuesta corta.

Al final, Quiz Complete muestra lo que sabes bien (Strong) y lo que Needs Review. Flashcards for weak areas convierte los puntos débiles en tarjetas para tu mazo.

Explorar y buscar

  • Search (Ctrl+K o /) encuentra tarjetas, mazos y etiquetas desde cualquier sitio.
  • Browse (B) lista todas tus tarjetas en una tabla. Filtra con palabras, tag:nombre (o #nombre) y deck:nombre; usa las pestañas para tarjetas pendientes, en aprendizaje, nuevas y suspendidas; ordena y elige las columnas.
  • Selecciona tarjetas (X o Ctrl+clic) para Move to deck…, Suspend / Unsuspend, Reset to new, Duplicate o Delete varias a la vez.

Una tarjeta suspendida (suspended) sigue en su mazo pero queda fuera de los repasos hasta que la reactives.

Importar, copia de seguridad y sincronización

Importar desde Anki

Import en la barra lateral acepta paquetes de Anki (.apkg, .colpkg) con sus imágenes y audio, conservando su estructura de mazos. Para cada paquete eliges si se convierte en tarjetas de conocimiento o de palabras. Los paquetes grandes siguen importándose en segundo plano: el panel de la esquina muestra el progreso.

Sincronización

Todo se guarda en tu cuenta mientras trabajas y te sigue a cualquier dispositivo donde inicies sesión. Sync Now en la barra superior envía al instante los cambios pendientes.

Copia de seguridad

En la página Sync, Export JSON descarga una copia de todos tus mazos, documentos, tarjetas e historial de repasos. Import JSON restaura una copia así — sustituye todo lo que hay ahora en tu cuenta. Reset sample data borra tus datos y restaura los mazos de ejemplo.

Estadísticas

Stats muestra las tarjetas estudiadas hoy, tu tasa de Again, el total de repasos, cuántas tarjetas tienes en cada estado, tus repasos de los últimos 14 días y una previsión de las tarjetas pendientes en los próximos 14 días.

Ajustes

Abre Settings con el icono del engranaje en la barra superior. Los cambios se aplican al instante.

SecciónQué puedes cambiar
AccountVer con qué cuenta has iniciado sesión y cerrar la sesión.
AppearanceEl tema (Light, Dark o el del sistema) y si los gestos de deslizar / tocar dos veces están activados en el repaso. Ambos se guardan solo en este navegador.
AIMuestra si la IA está conectada (con Test connection) o funciona con las reglas integradas sin conexión.
Read aloudGoogle voice (natural, igual en todos los dispositivos, dentro de un cupo mensual que se muestra aquí) o Browser voice (gratis e ilimitada; la calidad depende del dispositivo). En Settings → Text-to-Speech & Voices eliges una voz de Google para cada idioma, ajustas la velocidad de reproducción y la reproducción automática del audio de las tarjetas, o usas la opción predeterminada de la app. Tus elecciones te siguen con la cuenta. Cuando se agota el cupo, toma el relevo la voz del navegador.
Daily LimitsNew cards/day y Maximum reviews/day, por mazo. Ambos son ilimitados hasta que escribes un número; vacía el campo para volver a ilimitado.
FSRS SchedulerDesired retention (90 % por defecto): más alto significa que recuerdas más pero repasas con más frecuencia.
Help & FeedbackEnviar comentarios, unirte a la comunidad de Discord y abrir esta guía.

Cada mazo también tiene sus propios Deck settings…: su nombre y, en un mazo que enseña un idioma, los idiomas y la reproducción automática del audio.

Atajos y gestos

Pulsa ? en la app para ver esta lista en cualquier momento. La lista de abajo es la de la propia app, por eso aparece en inglés.

Global

Ctrl+K / /Search cards, decks, tags
Space / SStudy the current deck, or the open tab (Knowledge / Vocab) on Today and folders
VVoice study (Pro): the same, out loud
AAdd card
DDecks overview
BBrowse all cards
[Show / hide the sidebar
?Show this list

Review

Space / EnterShow answer, then Good
1 2 3 4Again · Hard · Good · Easy
EEdit current card
RReplay the card’s audio
HOpen / close the card’s hint
EnterIn the answer box: check the typed answer
MVoice review (Pro; started with "Study by speaking" or the mic in the header): the question is read aloud, then recording starts by itself; Space or P pauses it while you think (and goes on), M or Enter ends and sends it; AI checks it and suggests a rating
VRead aloud: the selection, or the whole side (skips code and diagrams); while reading, pause / resume
← →While reading aloud: previous / next part (or click a line)
Ctrl+ZUndo last answer
EscStop reading aloud, or leave review

Quiz

1 2 3 4Choose an option
EnterCheck a typed answer, then the next question
Space / →Next question
P / ←Previous question
BFlag the question to come back to
FFocus: just the quiz
EscSave and leave (the quiz goes on where you left off)

Listening (a turn during study)

↑Play the word again
↓Play it slowly
EnterCheck, then take the suggested grade
1 2 3 4Grade it yourself: Again / Hard / Good / Easy
EscLeave the box, then leave the study session

Document

EEdit document
FFocus: just the document (Esc to leave)
Ctrl+SSave document
Ctrl+B / Ctrl+I / Ctrl+KBold · Italic · Link
Select textExplain · Simplify · Example · Quiz · Flashcard

Decks tree & card table

↑ ↓ ← →Move · collapse · expand
Enter / EOpen deck · edit card
F2Rename deck or folder
DelDelete
X / Ctrl+ClickSelect card

Touch (phones)

Swipe ←On the question: show the answer. On the answer: Good
Swipe →On the answer: Again
Double-tap rightOn the question: show the answer. On the answer: Good
Double-tap leftOn the answer: Again
UndoUndo the last answer from the review header or with Ctrl+Z
Select textRead the selection aloud
Tap a lineWhile reading aloud: read from there

Avisar de un problema

¿Has encontrado un error o tienes una idea para mejorar Docki? Cuéntanoslo desde la propia app:

  1. Abre el menú de tu cuenta (tus iniciales, arriba a la derecha) y elige Send feedback, o ve a Settings → Help & Feedback.
  2. Elige Report a bug o Suggest an idea, ponle un título corto y descríbelo. Si es un error, cuenta qué hiciste, qué pasó y qué esperabas.
  3. Añade hasta 3 capturas de pantalla: Add un archivo, o simplemente pega una captura (Ctrl+V) en el cuadro de diálogo.
  4. Si se ofrecen ambas, elige cómo enviarlo en Send via: Email (respondemos al correo de tu cuenta) o Discord (se publica en el Discord del equipo). Luego pulsa Send.

Junto con tu mensaje recibimos el correo de tu cuenta y la página en la que estabas, para poder reproducir el problema y responderte. Puedes enviar hasta 5 informes cada 10 minutos.

¿Prefieres charlar? Join our Discord (en el menú de la cuenta, el diálogo de comentarios y Settings) para hacer preguntas, seguir las novedades y hablar con otros estudiantes.

Solución de problemas

La barra lateral dice “Offline”.
Docki no puede conectar con el servidor ahora mismo. Deja la pestaña abierta: tus cambios se guardan y se envían en cuanto vuelva la conexión. Cerrar la pestaña antes de que diga Synced otra vez puede hacerte perderlos.
Las respuestas de la IA parecen muy básicas.
El servidor no tiene clave de IA, así que se usan las reglas integradas. Settings → AI muestra el estado actual.
La lectura en voz alta suena robótica o dejó de usar la voz de Google.
Es posible que se haya agotado tu cupo mensual de voz de Google (ver Settings → Read aloud) y haya tomado el relevo la voz del navegador. Microsoft Edge tiene las voces de navegador más naturales.
Hoy no hay nada que repasar.
Todas las tarjetas pendientes están hechas, o se alcanzó un límite diario que fijaste. Súbelo o quítalo en Settings → Daily Limits, o usa Study en un mazo para seguir.
Al deslizar en el móvil vuelvo a la página anterior.
Empieza el gesto sobre la tarjeta, no en el borde mismo de la pantalla: ese borde es el botón Atrás del navegador. Los gestos se pueden desactivar en Settings → Appearance.
Pasa algo más.
Avísanos con una captura de pantalla: nos ayuda muchísimo.