remark-docx

remark plugin to compile markdown to docx (Microsoft Word, Office Open XML).

🚧 WIP 🚧

This project is aiming to support all nodes in mdast syntax tree, but currently transformation and stylings may not be well.

If you have some feature requests or improvements, please create a issue or PR.

• paragraph
• heading
• thematicBreak
• blockquote
• list
• listItem
• table
• tableRow
• tableCell
• html
• code
• yaml
• toml
• definition
• footnoteDefinition
• text
• emphasis
• strong
• delete
• inlineCode
• break
• link
• image
• linkReference
• imageReference
• footnote
• footnoteReference
• LaTeX support with math and inlineMath (remark-math is required)

Demo

https://inokawa.github.io/remark-docx/

Install

1npm install remark-docx

Usage

Browser

1import { unified } from "unified";
2import markdown from "remark-parse";
3import docx from "remark-docx";
4import { saveAs } from "file-saver";
5
6const processor = unified().use(markdown).use(docx, { output: "blob" });
7
8const text = "# hello world";
9
10(async () => {
11  const doc = await processor.process(text);
12  const blob = await doc.result;
13  saveAs(blob, "example.docx");
14})();

Node.js

1import { unified } from "unified";
2import markdown from "remark-parse";
3import docx from "remark-docx";
4import * as fs from "fs";
5
6const processor = unified().use(markdown).use(docx, { output: "buffer" });
7
8const text = "# hello world";
9
10(async () => {
11  const doc = await processor.process(text);
12  const buffer = await doc.result;
13  fs.writeFileSync("example.docx", buffer);
14})();

Documentation

• API reference

Contribute

All contributions are welcome. If you find a problem, feel free to create an issue or a PR.

Making a Pull Request

1. Fork this repo.
2. Run npm install.
3. Commit your fix.
4. Add tests to cover the fix.
5. Make a PR and confirm all the CI checks passed.

Related projects

• remark-slate-transformer
• remark-pdf