Skip to content

MichelleGDyason/docx-exporter-plus

Repository files navigation

DOCX Exporter Plus

Obsidian plugin that exports the active Markdown note to .docx.

What it does:

  • Maps Markdown headings to real Word heading levels so the document is navigable in Microsoft Word.
  • Preserves clickable links.
  • Reads rendered text colors from Obsidian and adjusts overly light text so it stays readable on white paper.
  • Exports embedded images and Markdown note embeds.
  • Converts image captions into Word caption paragraphs with Word Figure sequence numbering.
  • Writes the exported .docx next to the source note.

Current scope:

  • Exports paragraphs, headings, lists, code blocks, horizontal rules, basic tables, images, and embedded Markdown notes.
  • Uses Obsidian's renderer before conversion, which helps preserve rendered links and inline styling.
  • Non-Markdown media embeds such as PDFs/audio/video currently export as file reference links rather than inline media.

Build:

npm install
npm run build

Manual install for local testing:

.obsidian/plugins/docx-exporter-plus

Copy these files into that folder:

  • main.js
  • manifest.json
  • styles.css

Community release notes:

  • The GitHub release tag must match the version in manifest.json.
  • Release assets should include main.js, manifest.json, and styles.css.

Future releases:

git tag 0.1.4
git push origin 0.1.4

That tag triggers the GitHub Actions release workflow, which rebuilds the plugin, uploads the release assets, and generates GitHub artifact attestations for them.

About

Obsidian plugin that exports Markdown notes to DOCX with Word headings, links, images, embeds, and captions.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors