Skip to main content

How-to

Dictation in Obsidian on a Mac

Obsidian ships no speech-to-text of its own. It does ship an autocomplete that fires on a character dictation produces by accident.

Last updated: 2026-08-29

Obsidian's core plugin list contains no speech-to-text, so dictating into a vault means using a system tool against a markdown editor. That editor treats several characters as syntax, and dictation produces those characters whenever you speak their names.

The Obsidian-specific trap: double brackets open the link picker

Typing two opening square brackets in an Obsidian note opens the internal-link suggestion popup, and every keystroke after that filters the list of notes in your vault instead of entering the note. Dictation reaches this in two ways: saying "open bracket open bracket" outright, and saying a single "open bracket" while Obsidian's auto-pair setting inserts the closing one for you. The symptom is a sentence that stops mid-word with a floating list of note titles over it, and a Return that inserts a wikilink to an unrelated note.

  • Press Escape to dismiss the popup, then delete the brackets and carry on.
  • Auto-pairing is a toggle: Settings → Editor → Auto pair brackets. Turning it off while you dictate long passages removes half of the accidental triggers.
  • The same applies to a dictated hash at the start of a line, which Obsidian turns into a heading, and to a dictated hyphen followed by a space, which starts a bullet list.

Dictate into a note

  1. Turn Dictation on once: System Settings → Keyboard → Dictation. Full steps in enable dictation on macOS.
  2. Open the note. Obsidian must be in an editing mode, not reading view. Command+E switches between them.
  3. Click where the text should go and start Dictation.
  4. Speak the passage. Say "comma" and "period"; leave the markdown characters out unless you want the formatting.
  5. Stop Dictation. Obsidian writes to the .md file on disk as you go.

Source mode is the calmer place to dictate

Live Preview re-renders each line as soon as it becomes valid markdown, which moves the visible cursor while dictation is still inserting text. Source mode shows the raw characters and does not re-render, so what you hear yourself say and what you see on screen stay in the same order. Switch per note from the note menu, or set the default under Settings → Editor → Default editing mode.

Why the vault is a good place to dictate

A vault is a folder of plain markdown files on your own disk. Combined with a dictation model that runs on the same Mac, a spoken note goes from microphone to file without touching a server at any point. That is not true of dictating into a browser-based notes tool, where the text ends up on someone else's infrastructure even when the recognition was local.

If nothing types at all

  • Obsidian is an Electron app and macOS treats it as its own microphone client. Check System Settings → Privacy & Security → Microphone for Obsidian by name, and separately for the dictation tool.
  • If dictated text appears and then vanishes, a community plugin that rewrites the editor buffer on change is the usual cause. Disable plugins under Settings → Community plugins and retest.
  • Dictation dead everywhere, not just Obsidian: dictation not working on Mac.

A hotkey that inserts in one pass

Voice Type writes punctuation from the audio instead of from spoken commands and inserts the whole passage on release, which means no stray brackets, no half-triggered link picker, and no re-render mid-sentence. The model runs on your Mac, so the note never leaves it: voice typing for Mac.

Keep going

Sources

Try Voice Type (7-day free trial)

Try it on your own work

Voice Type is on-device dictation for macOS. Hold a hotkey, speak, and release to insert text in any app. Your audio never leaves your Mac. Free for 7 days, then $19.99 once on the Mac App Store. No subscription and no account.

Start the free trial