A review, start to finish.
Here is what happens at each step inside Obsidian, and what does not.
1. Write, as you already do
Write Spanish in any Markdown note. Codazo does not read your vault, index it, or watch you type. Nothing leaves your device while you write.
2. Select and ask
Select a passage and run Codazo: Review selection from the command palette or the right-click menu, or Review current note for the whole note. A modal shows the exact text that will be sent, takes an optional note in English about what you meant (or reads it from a callout in your note titled English Intent, such as > [!spoiler]- English Intent, which is kept out of the text sent), lets you pick your level, and names the provider and model. Only the confirm button sends anything. Only the selected text and your optional note are sent: never the note's name, path, properties, links, or other notes.
3. Read feedback beside your note
A status bar at the top of the pane shows the request in flight with the profile it went to, then turns green when it lands or orange with the reason when it fails. Below it, your text appears with its phrases marked, then the observations, each in one of four categories:
- Ortografía / acento, including written accents.
- Gramática, such as agreement between subject and verb.
- Verbo / tiempo, mostly tense and form.
- Alternativa natural, an optional different way to say something that was already correct.
Hover a marked phrase to peek at its observation; click it to pin the observation and jump to the phrase in the editor. Each card leads with the suggestion and the explanation, and folds a little practice underneath: notice, question, hint, try again. Marks live in the editor only while the passage is unchanged, and are never written to the file.
contract:ANCHOR_NOT_FOUND. Codazo does not retry on its own, switch providers, or show sample text in place of a real result.4. Keep what you want, or nothing
Review results stay in memory until you choose. Each action creates a new Markdown note in your Codazo folder with flat codazo-* properties, and never touches the original:
- Guardar revisión: a readable review note carrying the exact source, every observation, the study material, provider and model, and a payload the plugin re-validates before showing it again.
- Crear nota de revisión mía: a copy of the passage in a new note, linked to the source and the review, for you to rewrite.
- Guardar hoja de estudio and Exportar JSON or HTML.
An optional setting saves every review automatically; when you open a note later, its newest saved review comes back with it. Saved notes are ordinary unencrypted Markdown and sync with the rest of your vault, and the plugin says so before the first save.
Another optional setting creates one note per word under Palabras/ and one per verb and tense under Verbos/ (for example dar · Presente de indicativo) after every review, study guide, or excerpt. Each carries a codazo-progreso property, nuevo by default, that you change as you learn: con-problemas, necesita-trabajo, casi-listo, dominado. Notes that already exist are never touched, so your progress survives every later review.
5. Study guides
Codazo: Study guide from selection skips the observations. The pane shows your text with the study words and verbs marked, then the words above your level with meanings and examples, and the verbs you used with the tense in play and a conjugation table from a pinned local reference. When the reference does not cover a form, Codazo says so rather than inventing one.
6. Excerpts, for what you read
Codazo: Excerpt from selection is the mirror of a review: no corrections, because you did not write the text. The dialog guesses whether you selected a word, a phrase, or a paragraph and lets you change it. A word gets its meaning, examples, and, if it is a verb form, its infinitive and tense with the conjugation table. A phrase gets up to three meaning notes: the literal reading, how it is actually used in conversation including slang or intended effect, and register or region. A paragraph is built like a study guide for your level with a few items that stretch it.
Excerpts are always saved, under Extractos/, with the passage, a link to where it came from, the words and verbs, and the meaning notes inside a folded callout. In the pane the meaning is folded too, labeled intenta primero, luego abre: try to work it out before you reveal the answer.
7. The index
The pane has two tabs. Resultado is the current review, study guide, or excerpt. Índice lists everything Codazo has saved in your vault, read from Obsidian's metadata cache, grouped by kind and with the open note's items first. Choosing a review, study sheet, or excerpt re-validates its saved payload and loads it into the pane with no model call, so you never re-run something to see it again. Words, verbs, and revisions open as notes.
8. Reading helpers
Inline translations need no model. Select a word or phrase, choose Add translation, type the English, and the text becomes {botas|boots} or {sepa la bola|who knows}. In both the editor and reading view you see only the Spanish with an underline, and hovering shows the translation. Putting the cursor inside a gloss shows the raw text for editing. Glosses are removed from anything sent to the model.
Insert English intent drops a folded callout at the cursor with a placeholder to type over. When a review runs, the callout's text prefills the intent field and the callout is kept out of the Spanish that is sent.
The right-click menu groups all of this: Interpretation holds the three actions that send text to the model and is disabled without a selection; Tools holds the helpers that never do.
If the note changes
A review is connected to the exact text it was made for. If that passage is no longer present exactly once in the note, the review stays visible as history, but editor marks and navigation switch off and the pane tells you why. Codazo never attaches old feedback to merely similar text.