# `@m2d/html` 
[](https://github.com/md2docx/html/actions/workflows/test.yml)
[](https://codecov.io/gh/md2docx/html)
[](https://www.npmjs.com/package/@m2d/html)
> Parses embedded **HTML** into extended **MDAST nodes** to unlock full HTML-to-DOCX conversion support.
---
## ๐ฆ Installation
```bash
npm install @m2d/html
```
```bash
pnpm add @m2d/html
```
```bash
yarn add @m2d/html
```
---
## ๐ Overview
The `@m2d/html` plugin for [`mdast2docx`](https://github.com/mayankchaudhari/mdast2docx) enables the parsing and transformation of **embedded raw HTML** inside Markdown into **extended MDAST**. This unlocks the ability to support features like images, tables, checkboxes, styles, and more โ using HTML tags directly inside your Markdown documents.
---
## โ ๏ธ Important
> **This plugin must be registered early in the plugin pipeline.**
> It transforms raw HTML into extended MDAST nodes, which are then handled by other `@m2d/*` plugins (such as `@m2d/image`, `@m2d/table`, etc).
> If used after other plugins, the HTML content, e.g, images, tables, or lists may be ignored or lost in the DOCX output.
---
## ๐ ๏ธ Usage
```ts
import { htmlPlugin } from "@m2d/html";
const plugins = [
htmlPlugin(), // โ
Must come first
imagePlugin(),
tablePlugin(),
];
```
---
## ๐งฉ How It Works
1. Parses raw embedded HTML using the DOM.
2. Converts DOM nodes to extended MDAST nodes.
3. Other `@m2d/*` plugins or the `@m2d/core` package consume these extended nodes to generate DOCX output.
> This plugin enriches the AST to enable other plugins and core engine to convert it to docx.
---
## โ
Supported Elements
| HTML Element | MDAST Node | Notes |
| ------------------------- | ----------------- | ------------------------------------ |
| `![]()
` | `image` | Supports styles and attributes |
| `
` | `break` | Line breaks |
| ``, `` | `strong` | Bold text |
| ``, `` | `emphasis` | Italics |
| ``, `` | `delete` | Strike-through |
| `` | `link` | Hyperlinks |
| `