Obsidian runs on Markdown. Word runs on... whatever Word runs on. If you're migrating notes, a thesis, or years of documents into Obsidian, the import step decides whether you get a clean vault or a cleanup project.
Here are the three methods that actually work, ranked by reliability.
Method 1: Convert to Markdown First, Then Drop Into Your Vault (Recommended)
The cleanest path: convert each .docx to a .md file with a dedicated converter, then move the files into your Obsidian vault folder. Obsidian picks them up instantly — no plugin needed.
- Convert your Word file at doctomd.com (free, 3/day, no signup) or with Pandoc:
pandoc thesis.docx -o thesis.md --extract-media=./assets - Move the
.mdfile (and any extractedassets/folder) into your vault. - Open Obsidian — the note is there, images linked, tables rendered.
Why this wins: you control the conversion quality before it touches your vault. Fix problems once, not note by note.
Watch out for:
- Wikilinks: Word has no
[[links]]. After import, use Obsidian's "Add internal link" or a regex find-replace to connect notes. - Attachments: make sure images land in your configured attachment folder (Settings → Files & Links).
- YAML frontmatter: add it manually or with the Linter plugin for tags/dates.
Method 2: Pandoc in Bulk
Migrating dozens of files? Script it:
for f in *.docx; do
pandoc "$f" -o "${f%.docx}.md" --extract-media="./assets"
done
Then move the whole batch into your vault. This is the fastest route for large migrations.
Downside: you'll still want to spot-check tables and footnotes — Pandoc is good, not perfect.
Method 3: Obsidian Community Plugins
Plugins like "Import" helpers exist, but in practice most wrap the same conversion libraries with less control over output. Fine for a file or two; for a real migration, Method 1 or 2 gives cleaner results.
Post-Import Cleanup Checklist
- Check tables render (merged cells are the usual casualty)
- Verify images resolved (no broken
![]()links) - Convert Word headings to proper
#levels - Strip leftover HTML tags (
<w:>cruft from bad converters) - Add tags and frontmatter
- Link related notes with
[[wikilinks]]
FAQ
Can Obsidian open .docx files directly? No. Obsidian only reads Markdown (and a few plain-text formats). You must convert first.
Will my Word formatting survive? Structure survives (headings, lists, tables, bold/italic). Pixel-perfect layout doesn't — that's the point of moving to Markdown.
What about very long documents (100+ pages)? Split before converting if possible, or convert whole and split the Markdown after. DocToMD's paid plans handle PDFs up to 99 pages; for very long Word docs, splitting into chapters first gives the cleanest result.
Bottom Line
Convert first, import second. One clean conversion pass beats fixing 50 notes inside Obsidian. Start with a free conversion at doctomd.com — no signup needed.