remark-docx 0.2.1 → 0.3.1

package/README.md

@@ -6,12 +6,11 @@
 
 - Uses [docx](https://github.com/dolanmiu/docx) for compilation.
 - Works in any environment (e.g. browser, Node.js).
+- You can customize [mdast](https://github.com/syntax-tree/mdast) to Word transformation with plugin system.
 
-### 🚧 WIP 🚧
+### Supported mdast nodes
 
-This project is aiming to support all nodes in [mdast](https://github.com/syntax-tree/mdast) syntax tree, but currently transformation and stylings may not be well.
-
-If you have some feature requests or improvements, please create a [issue](https://github.com/inokawa/remark-docx/issues) or [PR](https://github.com/inokawa/remark-docx/pulls).
+Currently, some of the default styles may not be nice. If you have feature requests or improvements, please create a [issue](https://github.com/inokawa/remark-docx/issues) or [PR](https://github.com/inokawa/remark-docx/pulls).
 
 - [x] paragraph
 - [x] heading
@@ -22,25 +21,21 @@ If you have some feature requests or improvements, please create a [issue](https
 - [x] table
 - [x] tableRow
 - [x] tableCell
-- [ ] html
-- [ ] code
-- [ ] yaml
-- [ ] toml
 - [x] definition
 - [x] footnoteDefinition
 - [x] text
 - [x] emphasis
 - [x] strong
 - [x] delete
-- [ ] inlineCode
 - [x] break
-- [x] link
-- [x] image
-- [x] linkReference
-- [x] imageReference
-- [x] footnote
-- [x] footnoteReference
-- [x] LaTeX support with math and inlineMath ([remark-math](https://github.com/remarkjs/remark-math) is required)
+- [x] link / linkReference
+- [x] image / imageReference ([remark-docx/plugins/image](#image) is required)
+- [x] footnote / footnoteReference
+- [ ] html
+- [ ] yaml
+- [ ] toml
+- [ ] code / inlineCode
+- [x] math / inlineMath ([remark-math](https://github.com/remarkjs/remark-math) and [remark-docx/plugins/math](#latex) are required)
 
 ## Demo
 
@@ -52,7 +47,7 @@ https://inokawa.github.io/remark-docx/
 npm install remark-docx
 ```
 
-## Usage
+## Getting started
 
 ### Browser
 
@@ -62,14 +57,14 @@ import markdown from "remark-parse";
 import docx from "remark-docx";
 import { saveAs } from "file-saver";
 
-const processor = unified().use(markdown).use(docx, { output: "blob" });
+const processor = unified().use(markdown).use(docx);
 
 const text = "# hello world";
 
 (async () => {
   const doc = await processor.process(text);
-  const blob = await doc.result;
-  saveAs(blob, "example.docx");
+  const arrayBuffer = await doc.result;
+  saveAs(new Blob([arrayBuffer]), "example.docx");
 })();
 ```
 
@@ -81,17 +76,45 @@ import markdown from "remark-parse";
 import docx from "remark-docx";
 import * as fs from "fs";
 
-const processor = unified().use(markdown).use(docx, { output: "buffer" });
+const processor = unified().use(markdown).use(docx);
 
 const text = "# hello world";
 
 (async () => {
   const doc = await processor.process(text);
-  const buffer = await doc.result;
-  fs.writeFileSync("example.docx", buffer);
+  const arrayBuffer = await doc.result;
+  fs.writeFileSync("example.docx", Buffer.from(arrayBuffer));
 })();
 ```
 
+## With plugins
+
+### Image
+
+```javascript
+import { unified } from "unified";
+import markdown from "remark-parse";
+import docx from "remark-docx";
+import { imagePlugin } from "remark-docx/plugins/image";
+
+const processor = unified()
+  .use(markdown)
+  .use(docx, { plugins: [imagePlugin()] });
+```
+
+### LaTeX
+
+```javascript
+import { unified } from "unified";
+import markdown from "remark-parse";
+import docx from "remark-docx";
+import { latexPlugin } from "remark-docx/plugins/math";
+
+const processor = unified()
+  .use(markdown)
+  .use(docx, { plugins: [latexPlugin()] });
+```
+
 ## Documentation
 
 - [API reference](./docs/API.md)