Typography
The smarty extension¶
The smarty extension is a built-in feature of Python Markdown that converts straight
quotes, dashes, and ellipses into their typographically correct “smart” equivalents.
In the Zensical documentation ecosystem, it is frequently paired with PyMdown’s
SmartSymbols extension to handle advanced typographical substitutions like fractions,
arrows, and trademark symbols.
Configuration¶
You can configure or adjust the smarty extension inside your zensical.toml configuration file:
zensical.toml
[project.markdown_extensions]
# Enable standard smarty rules or toggle specific parameters
smarty = { smart_quotes = true }
Typographical Replacements¶
| Input | Rendered Output | Description |
|---|---|---|
| "Hello" | “Hello” | Curly double quotes |
| 'Hello' | ‘Hello’ | Curly single quotes |
| -- | – | En-dash |
| --- | — | Em-dash |
| ... | … | Ellipsis |