A semantic text splitter that intelligently splits text by punctuation, preserves special patterns, and supports markdown content processing with multilingual support.
- Punctuation-based splitting: Intelligently splits text at sentence boundaries while preserving context
- Long sentence handling: Automatically splits sentences longer than 256 characters at appropriate break points
- Pattern protection: Preserves special patterns like URLs, emails, file extensions, and technical terms
- Chinese, Japanese, Korean (CJK): Full support for Asian languages with proper punctuation handling
- European languages: Support for languages with diacritical marks and special characters
- Middle Eastern languages: RTL text support including Arabic and Hebrew
- Mixed language content: Handles documents with multiple languages seamlessly
- Block-level processing: Handles headers, paragraphs, lists, tables, and code blocks
- Nested structures: Properly processes nested lists and complex document structures
- Table processing: Converts table data into header-value pairs for better semantic chunking
- Code preservation: Keeps code blocks intact as single chunks
- Citation handling: Preserves academic citations and reference formats
- Mathematical expressions: Protects mathematical formulas, ratios, and scientific notation
- Technical patterns: Handles configuration properties, version numbers, and IP addresses
- Scientific names: Preserves biological nomenclature and abbreviations
- URLs and emails: Preserves web addresses and email addresses
- File paths: Handles file extensions and directory paths
- HTML entities: Protects encoded characters and special symbols
- Quotation marks: Handles various quote styles including nested quotes
- Abbreviations: Preserves common abbreviations and acronyms
npm install @querycat/textsplitterimport { splitByPunctuation } from '@querycat/textsplitter';
const text = 'Hello world. This is a test. How are you?';
const chunks = splitByPunctuation(text);
console.log(chunks);
// Output: ['Hello world.', 'This is a test.', 'How are you?']import { splitIntoChunks } from '@querycat/textsplitter';
const markdownText = `
# Main Title
This is a paragraph with multiple sentences. Another sentence here.
## Section
- List item 1
- List item 2
- Nested item
`;
const chunks = splitIntoChunks(markdownText);
chunks.forEach(chunk => {
console.log(`Block ${chunk.blockIndex}: ${chunk.content}`);
});Splits text into semantic chunks based on punctuation marks.
Parameters:
text(string): The input text to splitmaxLength(number, optional): Maximum length for each chunk (default: 256)
Returns: Array of strings representing text chunks
Example:
const text = 'Dr. Smith arrived at 9 a.m. The meeting lasted 2 hours.';
const chunks = splitByPunctuation(text);
// Output: ['Dr. Smith arrived at 9 a.m. The meeting lasted 2 hours.']Processes markdown content and splits it into semantic chunks.
Parameters:
markdownText(string): Markdown formatted text
Returns: Array of objects with blockIndex and content properties
Example:
const markdown = '# Title\nParagraph text. Another sentence.';
const chunks = splitIntoChunks(markdown);
// Output: [
// { blockIndex: 0, content: 'Title' },
// { blockIndex: 1, content: 'Paragraph text.' },
// { blockIndex: 1, content: 'Another sentence.' }
// ]The splitter automatically handles sentences longer than the maximum length:
const longText = 'a'.repeat(200) + ', ' + 'b'.repeat(200);
const chunks = splitByPunctuation(longText);
// Automatically splits at comma while preserving punctuationconst multilingualText = '今天天气真好。我们去公园玩吧！你觉得怎么样？';
const chunks = splitByPunctuation(multilingualText);
// Output: ['今天天气真好。', '我们去公园玩吧！', '你觉得怎么样？']const technicalText = 'Configure kafka.consumer.request.timeout.ms=3000. Visit https://example.com for details.';
const chunks = splitByPunctuation(technicalText);
// Preserves configuration properties and URLsconst academicText = 'According to Smith et al. (2023), the results were significant. See references (1, 2, 3) for details.';
const chunks = splitByPunctuation(academicText);
// Preserves citation formats and reference numbersThe splitter automatically protects various patterns:
- URLs:
https://example.com/path?param=1 - Emails:
user@example.com - File paths:
document.pdf,C:\Program Files\App - IP addresses:
192.168.1.1 - Version numbers:
v1.2.3,Node.js 18.15.0 - Mathematical expressions:
E = mc^2,x = 1.5 - Ratios:
1:2:3,A:B = 3:7 - Academic citations:
Smith, J. R. (2023) - Configuration properties:
database.connection.timeout=5000 - HTML entities:
&,©, 
- Chinese: Full support for simplified and traditional Chinese
- Japanese: Handles hiragana, katakana, and kanji
- Korean: Complete Hangul support
- Thai: Thai script support
- Diacritical marks: Café, naïve, résumé
- Special characters: German umlauts, French accents
- Cyrillic: Russian and other Cyrillic scripts
- Arabic: Complete RTL support
- Hebrew: RTL text processing
- Persian: Farsi language support
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see the LICENSE file for details.
text-splitter, semantic-chunking, punctuation-splitting, markdown-processing, multilingual, chinese, japanese, korean, academic-text, citation-handling, pattern-protection, sentence-splitting, text-processing, nlp, chunking