Using SoMark in RAGFlow

​

Configuration flow

1

Confirm the Base URL

Confirm the SoMark API Base URL based on your deployment type.

Deployment	Base URL
Official SoMark API	https://somark.ai/api/v1
Self-hosted SoMark	API Base URL of your self-hosted service

2

Add the SoMark model provider

In RAGFlow, open user settings, go to the model provider settings page, select SoMark from the model provider list, and add a SoMark OCR model instance.

3

Fill in model settings

Fill in the following settings:

Field	Required	Recommended value	Description
Instance name	Yes	somark	Provider instance name in RAGFlow
Model name	Yes	somark or a custom name	OCR model name used in parsing settings
Base URL	Yes	https://somark.ai/api/v1	SoMark API address
API Key	Required for official API	sk-...	SoMark API Key; can be left empty for self-hosted deployments

4

Configure element output formats

Configure the return formats for images, formulas, tables, and chemical structures as needed.

Setting	Default	Options	Description
Image format	url	url, base64, none	How image elements are returned
Formula format	latex	latex, mathml, ascii	How formula elements are returned
Table format	html	html, markdown, image	How table elements are returned
Chemical structure format	image	image	How chemical structures are returned

5

Configure parsing capability switches

Enable or disable parsing capabilities as needed.

Setting	Default	Description
Text cross-page merging	Off	Merge text that spans pages into continuous paragraphs
Table cross-page merging	Off	Merge tables that span pages into complete tables
Title level recognition	Off	Recognize heading levels such as H1, H2, and H3
Inline images	Off	Return images embedded in text paragraphs
Table images	On	Return images embedded in table cells
Image understanding	On	Perform semantic understanding and structured description for document images
Keep headers and footers	Off	Keep header and footer content when enabled

6

Select SoMark in the knowledge base

Open the RAGFlow knowledge base where you want to import the PDF, upload the PDF file, open parsing settings, and set the PDF parsing method to SoMark.

7

Start parsing

Start the parsing task and wait for RAGFlow to complete the downstream ingestion flow. RAGFlow submits the PDF file to SoMark, polls the async parsing task, retrieves the structured JSON result, converts SoMark blocks to RAGFlow internal structures, and continues chunking, indexing, and vectorization.

​

Parsing result mapping

​

Notes

• SoMark is currently mainly used for PDF parsing in RAGFlow.
• After document parsing succeeds, RAGFlow continues its existing knowledge base chunking, indexing, and vectorization flow.
• If a knowledge base uses SoMark for parsing, you still need to configure an embedding model normally. Otherwise, the downstream ingestion flow cannot complete.