@mazix/n8n-nodes-converter-documents
Advanced tools
n8n node to convert various document formats (DOCX, XML, YML, XLS, XLSX, CSV, PDF, TXT, PPT, PPTX, HTML, JSON, ODT, ODP, ODS) to JSON or text format
🚀 n8n community node for converting various document formats to JSON/text with AI-friendly output
🎯 Core Features
|
🔒 Security & Performance
|
| Category | Formats | Status |
|---|---|---|
| Text Documents | DOCX, ODT, TXT, PDF | ✅ Full Support |
| Spreadsheets | XLSX, ODS, CSV | ✅ Multi-sheet support |
| Presentations | PPTX, ODP | ✅ Full Support |
| Web & Data | HTML, HTM, XML, JSON | ✅ Full Support |
| E-commerce | YML (Yandex Market) | ✅ Specialized parsing |
| Legacy | DOC, PPT, XLS | ❌ Not supported* |
*Legacy formats require conversion to modern formats (DOCX, PPTX, XLSX)
Latest: Node renamed to "Document Converter" in v1.0.22
| 📝 Plain Text (Default) | 🌐 HTML Format |
|---|---|
|
Best for:
Output size: ~3,600 chars |
Best for:
Output size: ~58,000 chars (+1,591%) |
1. Add "Document Converter" node
2. Select "Output Format (DOCX)" parameter:
• Plain Text → Simple extraction
• HTML → Tables + formatting preserved
{
"text": "Situation: Often search by one field\nAction: Create index on that field"
}
{
"text": "<table><tr><td><strong>Situation</strong></td><td><strong>Action</strong></td></tr><tr><td>Often search by one field</td><td>Create index on that field</td></tr></table>"
}
| Feature | Description |
|---|---|
| Tables | <table>, <tr>, <td> - full structure preserved |
| Formatting | <strong>, <em>, <h1>-<h6> |
| Lists | <ul>, <ol>, <li> |
| Paragraphs | <p> tags for structure |
| AI-Friendly | ✅ Understood by ChatGPT, Claude, Gemini |
{
"sheets": {
"Products": [
{ "A": "ID", "B": "Name", "C": "Price" },
{ "A": 1, "B": "Apple", "C": 100 },
{ "A": 2, "B": "Banana", "C": 50 }
],
"Orders": [
{ "A": "Order", "B": "Quantity" },
{ "A": 101, "B": 5 }
]
}
}
| Feature | Details |
|---|---|
| Multiple Sheets | Each sheet = separate array in sheets object |
| Column Names | A, B, C... Z (Excel-style) |
| Row Format | Array of objects (rows) |
| Empty Cells | Skipped (only filled cells included) |
| Size Limit | 10,000 rows per sheet (configurable) |
| Memory Safe | Large files auto-limited to prevent OOM |
Via n8n web interface:
Settings → Community nodes → Install
Package name: @mazix/n8n-nodes-converter-documents
Or via command line:
npm install @mazix/n8n-nodes-converter-documents
# 1. Clone and build
git clone https://github.com/mazixs/n8n-node-converter-documents.git
cd n8n-node-converter-documents
npm install
npm run standalone
# 2. Copy to n8n
cp -r ./standalone ~/.n8n/custom-nodes/n8n-node-converter-documents
cd ~/.n8n/custom-nodes/n8n-node-converter-documents
npm install
# 3. Restart n8n
mkdir -p ~/.n8n/custom-nodes/n8n-node-converter-documents
cp dist/*.js dist/*.svg ~/.n8n/custom-nodes/n8n-node-converter-documents/
cp package.json ~/.n8n/custom-nodes/n8n-node-converter-documents/
cd ~/.n8n/custom-nodes/n8n-node-converter-documents
npm install --production
{
"text": "Extracted text content...",
"metadata": {
"fileName": "document.docx",
"fileSize": 12345,
"fileType": "docx",
"processedAt": "2024-06-01T12:00:00.000Z"
}
}
{
"sheets": {
"Sheet1": [
{ "A": "Name", "B": "Age", "C": "City" },
{ "A": "Alice", "B": 30, "C": "Moscow" },
{ "A": "Bob", "B": 25, "C": "SPB" }
]
},
"metadata": {
"fileName": "data.xlsx",
"fileSize": 23456,
"fileType": "xlsx"
}
}
Input:
{
"user": {
"name": "John",
"address": { "city": "Moscow" }
}
}
Output (flattened):
{
"text": "{\n \"user.name\": \"John\",\n \"user.address.city\": \"Moscow\"\n}",
"warning": "Multi-level JSON structure was converted to flat object"
}
DOCX Processing Flow:
┌─────────────────────────────────────┐
│ 1. If outputFormat === 'html': │
│ → mammoth.convertToHtml() │
│ → [Success] Return HTML │
│ → [Fail] Fallback to text │
│ │
│ 2. Text mode (default): │
│ → officeparser (primary) │
│ → mammoth.extractRawText (fb) │
│ → XML direct parsing (last) │
└─────────────────────────────────────┘
|
Core Libraries
|
Build & Quality
|
| Feature | Implementation |
|---|---|
| Input Validation | Strict type & structure checks |
| XSS Protection | sanitize-html library |
| Path Traversal | File name sanitization |
| Memory Limits | 10K rows/sheet, 50MB default |
| Dependency Audit | Regular npm audit checks |
npm install # Install dependencies
npm run dev # Watch mode
npm run build # Compile
npm test # Run 80 tests
npm run lint # Check code quality
| Command | Description |
|---|---|
npm run build | TypeScript → JavaScript |
npm run bundle | Webpack bundling |
npm run standalone | Standalone with deps |
npm run test:coverage | Coverage report |
npm run lint:fix | Auto-fix issues |
├── src/
│ ├── FileToJsonNode.node.ts # Main node (Strategy Pattern)
│ ├── helpers.ts # Utilities
│ └── errors.ts # Custom errors
├── test/
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── samples/ # Test files
├── docs/ # Documentation
│ ├── SOLUTION.md
│ ├── HTML_CONVERSION_PLAN.md
│ └── MAMMOTH_ANALYSIS.md
└── dist/ # Compiled output
|
🎨 UI & Quality
|
📚 Docs & Tests
|
What's New:
+ Node renamed to "Document Converter" (better UX)
+ Icon size fixed: 2048×1853 → 60×60
+ Code quality: eliminated all duplication
+ BaseConverterError class (DRY principle)
+ checkCFBFormat() helper (unified CFB check)
+ processViaOfficeParser() helper (unified error handling)
+ Full JSDoc documentation added
+ README complete visual redesign
+ 7 new XLSX multi-sheet tests
| Document | Description |
|---|---|
| CHANGELOG.md | Complete version history |
| SOLUTION.md | Architecture overview |
| HTML_CONVERSION_PLAN.md | DOCX to HTML implementation |
| MAMMOTH_ANALYSIS.md | Library research findings |
| optimization_plan.md | Performance strategies |
| security.md | Security features |
Error: Cannot find module 'exceljs'
# Solution 1: Use standalone version (recommended)
npm run standalone
# Solution 2: Check dependencies
cd ~/.n8n/custom-nodes/n8n-node-converter-documents
npm list
npm install
Large files causing OOM
maxFileSize parameter| Limitation | Details | Workaround |
|---|---|---|
| Legacy formats | DOC, PPT, XLS not supported | Convert to DOCX, PPTX, XLSX |
| Memory | Large PDF/XLSX load into RAM | Split files or increase memory |
| File size | Default 50MB limit | Configurable up to 100MB |
Issues and pull requests are welcome!
MIT © mazix
Made with ❤️ for the n8n community
If you find this helpful, please ⭐ star the repository!
[1.0.22] - 2025-10-10
FileToJsonNode.node.ts (Reduced by 78 lines):
checkCFBFormat() helper (was duplicated in DOC/PPT)processViaOfficeParser() for ODT/ODP/ODS (eliminated 3× duplication)errors.ts (Enhanced with base class):
BaseConverterError classError.captureStackTrace for debugginghelpers.ts (Enhanced documentation):
icon.svg (Fixed size):
README.md (Complete redesign):
test/integration/xlsx-sheets.test.ts
| Metric | Before | After | Improvement | |--------|--------|-------|-------------| | Code duplication | 3 places | 0 | ✅ 100% eliminated | | Lines of code | 920 | 870 | ↓ 50 lines | | Error handling coverage | Incomplete | 100% | ✅ Fixed PPTX | | Documentation | Basic | Full JSDoc | ✅ Complete | | Test coverage | 73 tests | 80 tests | +7 tests |
package.json: Version bump to 1.0.22src/FileToJsonNode.node.ts: -78 lines, +2 helper functionssrc/errors.ts: Added BaseConverterError classsrc/helpers.ts: Added full JSDoc documentationsrc/icon.svg: Fixed dimensions (60×60)README.md: Complete visual redesigntest/integration/xlsx-sheets.test.ts: +7 new testsdocs/README.md: Updated node namedocs/HTML_CONVERSION_PLAN.md: Updated node nameFAQs
n8n node to convert various document formats (DOCX, XML, YML, XLS, XLSX, CSV, PDF, TXT, PPT, PPTX, HTML, JSON, ODT, ODP, ODS) to JSON or text format
The npm package @mazix/n8n-nodes-converter-documents receives a total of 145 weekly downloads. As such, @mazix/n8n-nodes-converter-documents popularity was classified as not popular.
We found that @mazix/n8n-nodes-converter-documents demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Socket researchers identified a malicious Chrome extension that manipulates Raydium swaps to inject an undisclosed SOL transfer, quietly routing fees to an attacker wallet.
Research
/Security News
Another wave of Shai-Hulud campaign has hit npm with more than 500 packages and 700+ versions affected.
Product
Add real-time Socket webhook events to your workflows to automatically receive software supply chain alert changes in real time.