Skip to content

Feat: Enhanced DOCX Extraction with Table Content Support #2383

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
danielaskdd merged 4 commits into from
Nov 18, 2025
+42 −3
Merged

Feat: Enhanced DOCX Extraction with Table Content Support #2383

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4438ba4
Enhance DOCX extraction to preserve document order with tables
danielaskdd Nov 18, 2025
fa887d8
Fix table column structure preservation in DOCX extraction
danielaskdd Nov 18, 2025
186c8f0
Preserve blank paragraphs in DOCX extraction to maintain spacing
danielaskdd Nov 18, 2025
e7d2803
Remove text stripping in DOCX extraction to preserve whitespace
danielaskdd Nov 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 42 additions & 3 deletions lightrag/api/routers/document_routes.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -976,19 +976,58 @@ def _extract_pdf_pypdf(file_bytes: bytes, password: str = None) -> str:


def _extract_docx(file_bytes: bytes) -> str:
"""Extract DOCX content (synchronous).
"""Extract DOCX content including tables in document order (synchronous).

Args:
file_bytes: DOCX file content as bytes

Returns:
str: Extracted text content
str: Extracted text content with tables in their original positions.
Tables are separated from paragraphs with blank lines for clarity.
"""
from docx import Document # type: ignore
from docx.table import Table # type: ignore
from docx.text.paragraph import Paragraph # type: ignore

docx_file = BytesIO(file_bytes)
doc = Document(docx_file)
return "\n".join([paragraph.text for paragraph in doc.paragraphs])

content_parts = []
in_table = False # Track if we're currently processing a table

# Iterate through all body elements in document order
for element in doc.element.body:
# Check if element is a paragraph
if element.tag.endswith("p"):
# If coming out of a table, add blank line after table
if in_table:
content_parts.append("") # Blank line after table
in_table = False

paragraph = Paragraph(element, doc)
text = paragraph.text
# Always append to preserve document spacing (including blank paragraphs)
content_parts.append(text)

# Check if element is a table
elif element.tag.endswith("tbl"):
# Add blank line before table (if content exists)
if content_parts and not in_table:
content_parts.append("") # Blank line before table

in_table = True
table = Table(element, doc)
for row in table.rows:
row_text = []
for cell in row.cells:
cell_text = cell.text
# Always append cell text to preserve column structure
row_text.append(cell_text)
# Only add row if at least one cell has content
if any(cell for cell in row_text):
content_parts.append("\t".join(row_text))

return "\n".join(content_parts)


def _extract_pptx(file_bytes: bytes) -> str:
Expand Down
Loading