# 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:

```bash
npm install
npm run build
```

Manual install for local testing:

```text
.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:

```bash
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.