Operations Reference

Complete reference for all 100+ text transformation operations available in BotWash. Operations are organized by category and can be combined in formulas.

Overview

Each operation transforms text in a specific way. Operations have configurable parameters that control their behavior. When you create a formula, you stack operations in order - they execute sequentially from top to bottom.

Structure & Flow

Control how text is organized, broken into paragraphs, and structured.

sentence_splitter

Splits long sentences into shorter ones based on a maximum length.

  • max_len- Maximum sentence length in words

sentence_merger

Combines short sentences when they are closely related.

  • min_len- Minimum length to trigger merging
  • cohesion_threshold- How related sentences must be (0-1)

sentence_variance_optimizer

Optimizes sentence length variance for more natural-sounding text.

  • target_variance- Target variance level (optional)
  • preserve_short- Preserve intentionally short sentences (optional)

paragraph_rechunker

Reorganizes text into paragraphs of target length.

  • target_lines_per_para- Target paragraph size
  • max_para_len- Maximum paragraph length in lines

listifier

Converts text into bulleted or numbered lists.

  • max_items- Maximum list items to create
  • keep_sentences- Preserve sentence structure

delistifier

Converts lists back into prose paragraphs.

  • joiner_style- Style of connection (narrative/technical)

list_sorter

Sorts list items alphabetically, numerically, or by length.

  • order- Sort order (alpha/numeric/length)
  • direction- Direction (asc/desc)

heading_normalizer

Fixes heading hierarchy and levels.

  • start_level- Starting heading level
  • fix_hierarchy- Auto-fix broken hierarchy

line_wrapper

Wraps long lines at specified width.

  • max_width- Maximum line width in characters
  • break_words- Allow breaking words mid-word

quote_formatter

Formats quotes as blockquotes or inline.

  • style- Quote style (blockquote/inline)
  • attribution_format- How to format attribution

table_normalizer

Normalizes table formatting and alignment.

  • align_columns- Align table columns
  • padding- Cell padding amount

section_numbering

Adds or removes section numbers.

  • action- Add or remove numbers
  • format- Numbering format (1.1/I.A/(1))

footnote_organizer

Organizes and formats footnotes.

  • style- Footnote style (numeric/symbolic)
  • placement- Where to place footnotes (bottom/inline)

toc_generator

Generates a table of contents from headings.

  • max_depth- Maximum heading depth
  • include_numbers- Include section numbers

Tone & Style

Adjust the voice, formality, and emotional tone of text.

hedge_reducer

Removes hedge words like "maybe", "perhaps", "possibly".

  • level- How many hedges to remove (0-10)
  • keep_politeness- Preserve polite hedges
  • probability- Probability of removal (0-1, optional)

formality_tuner

Comprehensively adjusts formality level with 140+ transformations. Formal mode converts casual language to professional (80+ patterns including greetings, slang, phrasal verbs, intensifiers). Casual mode makes formal text more conversational (60+ patterns).

  • level- Target formality (casual/formal)

empathy_injector

Adds empathetic language and understanding.

  • intensity- How much empathy to add (0-10)
  • avoid_patronizing- Avoid sounding condescending

assertiveness_tuner

Makes text more or less assertive.

  • direction- More or less assertive
  • level- Amount of change (0-10)

humor_spritz

Adds personality and humor through 100+ transformations across 4 levels. Level 0.3: playful transitions. Level 0.5: conversational expressions. Level 0.7: idioms and personality. Level 0.8: dramatic flair. Level 0.9: technical puns (if enabled).

  • subtlety- Humor intensity level (0-1, where 1 is most humorous)
  • ban_puns- Disable technical wordplay and puns

sentiment_shifter

Adjusts emotional tone toward positive, negative, or neutral.

  • target- Target sentiment (positive/negative/neutral)
  • intensity- Strength of shift (0-10)

gender_neutralizer

Makes language gender-neutral by replacing gendered job titles and terms (chairman→chairperson, fireman→firefighter, etc.) plus pronoun handling. Includes 15+ gendered term replacements applied to all strategies.

  • strategy- Pronoun strategy (they: replace with they/them/their, plural: no pronoun changes, omit: remove pronouns)

voice_normalizer

Normalizes to first, second, or third person.

  • target- Target perspective (1p/2p/3p)

question_converter

Converts statements to questions or vice versa.

  • mode- Direction (to_questions/to_statements)

exclamation_normalizer

Normalizes excessive exclamation marks.

  • max_consecutive- Maximum consecutive marks allowed
  • replacement- What to replace with

rhetorical_enhancer

Adds 11 rhetorical devices for persuasive writing: question (rhetorical questions), anaphora (repetition at beginning), tricolon (rule of three), parallelism, alliteration, hyperbole, antithesis (contrasting ideas), epistrophe (repetition at end), repetition (emphasis), metaphor, amplification (building crescendo).

  • devices- Array of device names to apply (e.g., ['question', 'hyperbole', 'metaphor'])
  • frequency- Application probability (0-1, where 1 always applies)

Clarity & Simplicity

Make text clearer, more concise, and easier to understand.

active_voice_enforcer

Converts passive voice to active voice.

  • aggressiveness- How aggressively to convert (0-10)

readability_normalizer

Adjusts text to target reading grade level.

  • target_grade- Target grade level (1-20)

jargon_translator

Replaces jargon with plain language.

  • domain- Industry/domain (optional)
  • keep_glossary- Maintain glossary of terms

conciseness_tuner

Reduces word count while preserving meaning.

  • shrink_percent- Target reduction percentage

redundancy_pruner

Removes redundant phrases and repetitive content.

  • strictness- How strict to be (0-10)

plural_fixer

Fixes incorrect singular/plural forms.

  • aggressiveness- Confidence threshold (0-10)

synonym_simplifier

Replaces complex words with simpler synonyms.

  • target_grade- Target reading level
  • probability- Probability of replacement (0-1, optional)

acronym_expander

Expands acronyms on first use.

  • expand_first_only- Only expand first occurrence
  • custom_items- Custom acronym definitions (optional)

duplicate_remover

Removes duplicate or near-duplicate sentences.

  • min_length- Minimum sentence length to check
  • similarity_threshold- Similarity threshold (0-1)

transition_adder

Adds transition words between sentences/paragraphs.

  • frequency- How often to add transitions
  • types- Types of transitions to use

word_frequency_filter

Reduces overuse of specific words.

  • max_frequency- Maximum word occurrence count
  • exceptions- Words to ignore

Find & Replace

Pattern matching, character manipulation, and text substitution.

custom_replacer

Simple find and replace.

  • find- Text to find
  • replace- Replacement text
  • case_sensitive- Case-sensitive matching

regex_replacer

Advanced pattern matching with regular expressions.

  • pattern- Regular expression pattern
  • replacement- Replacement string
  • flags- Regex flags (g, i, m, etc.)

emoji_remover

Removes or filters emojis.

  • mode- Remove all or select
  • keep_list- Emojis to keep (optional)

special_char_remover

Removes or keeps specific special characters.

  • chars- Characters to process
  • mode- Remove or keep specified chars

unicode_normalizer

Normalizes Unicode characters.

  • target- Target format (ascii/nfc/nfd)

whitespace_controller

Normalizes whitespace and tabs.

  • tabs_to_spaces- Convert tabs to spaces
  • spaces_per_tab- Spaces per tab
  • trim_lines- Trim line ends

character_filter

Filters characters by type.

  • keep- What to keep (letters/numbers/alphanumeric/custom)
  • custom_chars- Custom character set (optional)

line_deduplicator

Removes duplicate lines.

  • case_sensitive- Case-sensitive comparison
  • trim_before_compare- Trim before comparing

prefix_suffix_manager

Adds or removes prefixes/suffixes.

  • action- Add or remove
  • type- Prefix or suffix
  • text- Text to add/remove

Polish & Correctness

Fix grammar, spelling, punctuation, and formatting.

spell_checker

Checks and optionally fixes spelling errors.

  • auto_fix- Automatically fix errors
  • dictionary- Dictionary variant (us/uk)

grammar_fixer

Fixes common grammar errors.

  • rules- Grammar rules to apply
  • aggressiveness- Confidence threshold (0-10)

punctuation_sanity

Normalizes punctuation style.

  • oxford_comma- Use Oxford comma
  • dash_style- Em dash or en dash

quote_smartener

Converts straight quotes to smart quotes.

  • style- Quote style (smart/straight/guillemets)

contraction_manager

Expands or contracts words.

  • mode- Expand or contract
  • probability- Probability of conversion (0-1, optional)
  • custom_items- Custom contractions (optional)

capitalization_style

Normalizes capitalization.

  • mode- Style (title/sentence/apa_title)

tense_normalizer

Normalizes verb tenses.

  • tense- Target tense (present/past)

person_perspective_normalizer

Normalizes grammatical person.

  • person- Target person (1p/2p/3p)

quote_attribution_clarity

Ensures quotes are properly attributed.

  • enforce_attribution- Require attribution for all quotes

terminology_consistency

Ensures consistent term usage.

  • glossary- Term mapping dictionary

number_formatter

Formats numbers with commas and rules.

  • spell_out_below- Spell out numbers below this (optional)
  • use_commas- Use comma separators (optional)
  • format- Number format style (optional)
  • locale- Locale for formatting (optional)

date_formatter

Formats dates consistently.

  • format- Format style (iso/us/eu/relative)

url_validator

Validates and fixes URLs.

  • fix_common_errors- Auto-fix common mistakes
  • require_protocol- Require http/https
  • validate_only- Only validate, don't fix (optional)

email_validator

Validates and fixes email addresses.

  • fix_common_errors- Auto-fix common mistakes
  • validate_only- Only validate, don't fix (optional)
  • normalize- Normalize email format (optional)

apostrophe_fixer

Fixes incorrect apostrophe usage.

  • fix_possessives- Fix possessive forms
  • fix_contractions- Fix contractions

comma_splice_fixer

Fixes comma splice errors.

  • strategy- How to fix (period/semicolon/conjunction)

dash_remover

Handles dashes and hyphens.

  • style- What to do with dashes (remove/spaces/commas/periods/hyphens)

ellipsis_normalizer

Normalizes ellipsis usage.

  • style- Ellipsis style (.../ …)
  • spaces- Add spaces around ellipsis

hyphenation_controller

Manages hyphenation.

  • action- Add or remove hyphens
  • compound_words- Handle compound words

space_normalizer

Normalizes spacing.

  • remove_double- Remove double spaces
  • trim- Trim leading/trailing spaces

i_capitalizer

Capitalizes standalone lowercase 'i' to 'I' (e.g., 'i think' → 'I think').

Numbers & Data

Format numbers, currencies, dates, and measurements.

number_speller

Spells out numbers as words.

  • max_value- Maximum value to spell out
  • ordinals- Handle ordinal numbers

number_compactor

Converts numbers to compact notation (1K, 1M).

  • min_value- Minimum value to compact

currency_formatter

Formats currency values.

  • currency- Currency code (USD, EUR, etc.)
  • symbol_position- Symbol placement (before/after)
  • include_thousands_separator- Use thousands separator (optional)
  • decimal_places- Number of decimal places (optional)

percentage_formatter

Formats percentage values.

  • decimal_places- Number of decimals
  • symbol_space- Space between number and %

fraction_converter

Converts between fraction formats.

  • target- Target format (decimal/spelled/fraction)

unit_converter

Converts between units of measurement.

  • from_unit- Source unit
  • to_unit- Target unit
  • precision- Decimal precision (optional)

ordinal_formatter

Formats ordinal numbers.

  • style- Format style (numeric/spelled)

phone_formatter

Formats phone numbers.

  • region- Country/region code
  • format- Format style (international/national)

time_formatter

Formats time values.

  • format- Time format (12h/24h)
  • show_seconds- Include seconds

measurement_normalizer

Normalizes measurements.

  • system- Unit system (metric/imperial)
  • precision- Decimal precision

Format & Markup

Convert between formats, handle HTML/Markdown, and manage code.

markdown_to_html

Converts Markdown to HTML.

  • sanitize- Sanitize HTML output
  • engine- Converter engine (showdown/remark, optional)
  • gfm- Use GitHub Flavored Markdown (optional)

html_to_markdown

Converts HTML to Markdown.

  • gfm- Use GitHub Flavored Markdown

html_sanitizer

Removes unsafe HTML.

  • allowed_tags- Allowed HTML tags
  • allowed_attrs- Allowed attributes

code_formatter

Formats code blocks.

  • language- Programming language (optional)
  • indent_size- Indentation size (optional)
  • mode- Formatting mode (wrap_block/wrap_inline/detect/indent, optional)
  • prettify- Apply code prettification (optional)

link_detector

Detects and auto-links URLs.

  • auto_link- Automatically create links
  • open_in_new_tab- Add target blank

html_entity_handler

Encodes or decodes HTML entities.

  • mode- Encode or decode

markdown_table_formatter

Formats Markdown tables.

  • alignment- Column alignment (left/center/right)

syntax_highlighter

Adds syntax highlighting to code.

  • theme- Color theme
  • line_numbers- Show line numbers

json_prettifier

Formats and prettifies JSON with auto-parsing of stringified JSON. Automatically detects and parses single, double, or multiply-stringified JSON at any nesting level.

  • mode- Output format (pretty/compact/sorted/aligned, default: pretty)
  • indent- Number of spaces for indentation (default: 2)
  • sort_keys- Sort object keys alphabetically (default: false)
  • trailing_newline- Add newline at end of output (default: true)
  • use_prettier- Use Prettier for formatting (default: true)

json_parser

Parses, validates, or extracts JSON from text.

  • mode- Operation mode (parse/validate/extract, default: parse)
  • on_error- Error handling (preserve/error_message/empty, default: error_message)
  • indent- Number of spaces for indentation (default: 2)

Removal & Redaction

Remove or redact specific types of content from text.

profanity_filter

Filters profanity and inappropriate language.

  • level- Filter level (light/moderate/strict)
  • mask_char- Character for masking (optional)

url_remover

Removes URLs from text.

  • mode- Remove or replace
  • replacement- Replacement text (optional)

hashtag_remover

Removes all hashtags (#tags) from text.

  • mode- Must be 'remove' (removes all hashtags)

email_redactor

Redacts email addresses.

  • mode- Mask or remove
  • replacement- Replacement text (optional)

mention_remover

Removes @mentions from text.

  • platform- Social platform (twitter/instagram/generic)

number_remover

Removes numbers from text.

  • mode- Remove or replace
  • replacement- Replacement text (optional)
  • include_currency- Also remove currency values
  • include_percentages- Also remove percentages

entity_redactor

Redacts named entities (people, places, organizations).

  • types- Entity types to redact
  • mode- Mask or remove
  • replacement- Replacement text (optional)

SEO & Web

Optimize content for search engines and social media.

meta_description_optimizer

Creates SEO-optimized meta descriptions.

  • max_length- Maximum character count
  • include_keywords- Keywords to include

slug_generator

Generates URL-friendly slugs.

  • max_length- Maximum slug length
  • separator- Separator character (-/_)

alt_text_generator

Generates alt text for images.

  • max_length- Maximum alt text length
  • descriptive- Use descriptive style

heading_seo_optimizer

Optimizes headings for SEO.

  • include_keywords- Target keywords
  • max_h1_length- Max H1 length

keyword_density_controller

Manages keyword density for SEO.

  • target_keyword- Keyword to optimize
  • target_density- Target density percentage

social_snippet_formatter

Formats content for social media.

  • platform- Social platform (twitter/facebook/linkedin)

schema_markup_adder

Adds structured data markup.

  • type- Schema type (article/product/recipe)

Accessibility

Make content more accessible to all users.

plain_language_converter

Converts to plain, accessible language.

  • max_grade- Maximum reading grade
  • preserve_technical- Keep technical terms

screen_reader_optimizer

Optimizes text for screen readers.

  • add_aria_labels- Add ARIA labels
  • expand_abbreviations- Expand abbreviations

abbreviation_expander

Expands abbreviations for clarity.

  • common_only- Only expand common abbreviations
  • add_glossary- Add glossary of terms
  • custom_items- Custom abbreviations (optional)

descriptive_link_text

Makes link text more descriptive.

  • min_length- Minimum link text length
  • context_words- Words of context to include

color_reference_remover

Removes color-based references for accessibility.

  • replacement_strategy- How to handle (describe/remove)

image_reference_handler

Ensures images have proper alt text.

  • mode- Operation mode (validate/remove/extract_context/generate_alt)
  • require_alt_text- Require alt text for all images
  • min_alt_length- Minimum alt text length
  • context_words- Number of context words for extraction

Content Transform

Advanced transformations like summarization and expansion.

summary_maker

Creates a summary of the text.

  • unit- Summary unit (words/sentences)
  • target- Target length
  • must_include- Required phrases (optional)

expander

Expands text with examples and details.

  • examples- Number of examples to add
  • evidence_first- Lead with evidence

call_to_action_crafter

Adds or enhances calls to action.

  • audience- Target audience
  • tone- CTA tone (optional)
  • strength- How strong the CTA should be (0-10)

audience_adapter

Adapts text for a specific audience.

  • persona- Target audience persona
  • grade- Reading grade level (optional)
  • domain_focus- Domain/industry (optional)

citation_normalizer

Normalizes citations to a specific style.

  • style- Citation style (APA/MLA/Chicago)
  • in_text_only- Only format in-text citations

Localization

Convert text between regional language variants.

spelling_converter

Converts spelling between American, British, and Canadian English variants (e.g., 'color' ↔ 'colour', 'organize' ↔ 'organise').

  • target- Target variant (american/british/canadian)
BotWash - The car wash for AI text