https://github.com/brrd/msoconvert
Convert Word and Excel documents in Node.js (Windows only)
https://github.com/brrd/msoconvert
convert doc docto docx office windows xls xlsx
Last synced: 3 months ago
JSON representation
Convert Word and Excel documents in Node.js (Windows only)
- Host: GitHub
- URL: https://github.com/brrd/msoconvert
- Owner: brrd
- License: mit
- Created: 2021-04-01T16:15:38.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-06-01T09:04:47.000Z (about 4 years ago)
- Last Synced: 2025-03-14T07:05:42.142Z (4 months ago)
- Topics: convert, doc, docto, docx, office, windows, xls, xlsx
- Language: JavaScript
- Homepage:
- Size: 1.35 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# msoconvert
Convert Word and Excel documents in Node.js (for Windows only). This is a wrapper around [DocTo](https://github.com/tobya/DocTo).
Microsoft Word/Excel must be installed on the system.
## Installation
```
npm install msoconvert --save
```
## Usage
```javascript
const convert = require("msoconvert");
// All the folling options are strings:
convert({
input, // Input file or directory path.
output, // Output file or directory path.
// The two following only apply if input is a directory:
inputExt, // Extension to search for if directory.
outputExt, // Output extension.
// Recommended:
encoding, // Output encoding (see below).
// Additional options:
use, // "word" (default) | "excel" | "powerpoint"
format, // wdSaveFormat for output (see below).
options // Additional arguments passed to docto.exe. Refer to DocTo documentation.
})
// A promise is returned.
.then(() => console.log("done"));
```
See [DocTo documentation](https://github.com/tobya/DocTo) for more information about API and additional parameters.
### `encoding`
Available encodings can be found in `enums/msoencodings.json`. It is possible to avoid the `msoencoding` prefix.
If `encoding` is not defined, msoconvert will use the default encoding defined in MS Office application settings. It is recommended to always define an encoding.
### `format`
`wdSaveFormat` enums:
* https://docs.microsoft.com/en-us/dotnet/api/microsoft.office.interop.word.wdsaveformat
* https://docs.microsoft.com/en-us/dotnet/api/microsoft.office.interop.excel.xlfileformat
If `format` is not defined, msoconvert will try to guess the format from `outputExt` if provided (otherwise an error will be thrown).