When processing Excel with the document extractor, there are vertical bars ("|") in the cells. The resulting markdown (md) format becomes messy #20291

Closed
opened 2026-02-21 20:06:42 -05:00 by yindo · 1 comment
Owner

Originally created by @ooodwbooo on GitHub (Nov 12, 2025).

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • This is only for bug report, if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :)
  • Please do not modify this template :) and fill in all the required fields.

Dify version

1.9.1

Cloud or Self Hosted

Self Hosted (Docker)

Steps to reproduce

When processing Excel with the document extractor, there are vertical bars ("|") in the cells. The resulting markdown (md) format becomes messy

✔️ Expected Behavior

When processing Excel with the document extractor, there are vertical bars ("|") in the cells. The resulting markdown (md) format becomes messy, which affects the subsequent processing by large models. Can we process it into CSV format instead, or escape the vertical bars as "|"?

Actual Behavior

The resulting markdown (md) format becomes messy

Originally created by @ooodwbooo on GitHub (Nov 12, 2025). ### Self Checks - [x] I have read the [Contributing Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) and [Language Policy](https://github.com/langgenius/dify/issues/1542). - [x] This is only for bug report, if you would like to ask a question, please head to [Discussions](https://github.com/langgenius/dify/discussions/categories/general). - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :) - [x] Please do not modify this template :) and fill in all the required fields. ### Dify version 1.9.1 ### Cloud or Self Hosted Self Hosted (Docker) ### Steps to reproduce When processing Excel with the document extractor, there are vertical bars ("|") in the cells. The resulting markdown (md) format becomes messy ### ✔️ Expected Behavior When processing Excel with the document extractor, there are vertical bars ("|") in the cells. The resulting markdown (md) format becomes messy, which affects the subsequent processing by large models. Can we process it into CSV format instead, or escape the vertical bars as "\|"? ### ❌ Actual Behavior The resulting markdown (md) format becomes messy
yindo added the 🐞 bug label 2026-02-21 20:06:42 -05:00
yindo closed this issue 2026-02-21 20:06:42 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Nov 12, 2025):

The root cause is that vertical bars (|) in cell content are not escaped during markdown table generation, which breaks markdown formatting. There is currently no built-in support in Dify's extractors to escape these bars or to export Excel data as CSV instead of markdown. The Excel extractor outputs semicolon-separated key-value pairs, while other extractors (like for Word or Notion) generate markdown tables but also do not escape vertical bars, leading to the same issue if cell content contains | reference.

As a workaround, you can preprocess your Excel data to replace | with \| before uploading, or post-process the markdown output to escape problematic characters. To fix this at the source, changes would be needed in the backend table-to-markdown logic to escape vertical bars in cell content before joining them into markdown tables.

If you need CSV output, you would need to implement or request a feature to support exporting Excel data as CSV during extraction, as this is not currently available.

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other  Chat with Dosu Join Discord Share on X

@dosubot[bot] commented on GitHub (Nov 12, 2025): <!-- Answer --> The root cause is that vertical bars (`|`) in cell content are not escaped during markdown table generation, which breaks markdown formatting. There is currently no built-in support in Dify's extractors to escape these bars or to export Excel data as CSV instead of markdown. The Excel extractor outputs semicolon-separated key-value pairs, while other extractors (like for Word or Notion) generate markdown tables but also do not escape vertical bars, leading to the same issue if cell content contains `|` [reference](https://github.com/langgenius/dify/blob/fe6538b08d786299a5c13c99f8593f8eae83a522/api/core/rag/extractor/excel_extractor.py#L13-L77). As a workaround, you can preprocess your Excel data to replace `|` with `\|` before uploading, or post-process the markdown output to escape problematic characters. To fix this at the source, changes would be needed in the backend table-to-markdown logic to escape vertical bars in cell content before joining them into markdown tables. If you need CSV output, you would need to implement or request a feature to support exporting Excel data as CSV during extraction, as this is not currently available. <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/8b8dd842-6d4c-4e47-a63e-d822efb9f8ed?feedback_type=other)</sup>&nbsp;&nbsp;[![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/6088a4f4-073a-43f3-b3d4-4f06fb0c05a0/ask?utm_source=github)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify/issues/28145)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#20291