Supported Tags
<phoneme> — Custom Pronunciation
<sub> — Text Substitution
<say-as> — Content Type Interpretation
Say-As Types
| Type | Input | Output |
|---|---|---|
characters / spell-out | ABC | ”A B C” |
cardinal / number | 123 | ”one hundred twenty-three” |
ordinal | 1 | ”first” |
digits | 123 | ”one two three” |
date | 12/25/2024 | ”December twenty-fifth twenty twenty-four” |
time | 2:30 | ”two thirty” |
telephone | 555-1234 | ”five five five one two three four” |
fraction | 3/4 | ”three quarters” |
Date Formats
| Format | Description | Example |
|---|---|---|
mdy | Month-Day-Year (default) | 12/25/2024 |
dmy | Day-Month-Year | 25/12/2024 |
ymd | Year-Month-Day | 2024-01-15 |
md | Month-Day | 12/25 |
dm | Day-Month | 25/12 |
y | Year only | 2024 |
m | Month only | 12 |
d | Day only | 25 |
Usage
Coexistence with Markdown
Both syntaxes work together:Edge Cases
- No SSML tags: Text passes through unchanged (fast path)
- Malformed tags: Invalid SSML passes through as literal text
- Unknown interpret-as: Content returned unchanged