BetterEm
Overview
BetterEM 是旨在改善重点（加粗和斜体）处理的扩展。 It provides two modes that control both asterisk's and underscore's bold and italic syntax: smart when smart_enable is turned on and normal if smart_enable is turned off. BetterEm overrides all the current bold and italic rules in Python Markdown with its own. When smart is enabled for either asterisks and/or underscores, it is enabled for all variants: single and double. When smart is enabled, the behavior will be very similar in feel to GFM bold and italic (but not necessarily exact).
The BetterEm extension can be included in Python Markdown by using the following:
import markdown
md = markdown.Markdown(extensions=['pymdownx.betterem'])
Reminder
Remember to read the Usage Notes for information that may be relevant when using this extension!
Rules
Note
For all examples on this page, underscores are smart and asterisks are not.
BetterEm requires that non-whitespace characters follow the opening token(s) and precede the closing token(s).
Whitespace Example
This * won't emphasize *
This will emphasize
This * won't emphasize *
This *will emphasize*
BetterEm allows for a more natural nested token feel.
Nested Token Example
I'm italic and bold I am just bold.
I'm bold and italic! I am just italic.
***I'm italic and bold* I am just bold.**
***I'm bold and italic!** I am just italic.*
BetterEm will try to prioritize the more sane option when nesting bold (**) between italic (*).
Prioritize Best Example
I'm italic. I'm bold and italic. I'm also just italic.
*I'm italic. **I'm bold and italic.** I'm also just italic.*
BetterEm will ensure smart mode doesn't terminate in scenarios where there are a large amount of consecutive tokens inside.
Consecutive Token Example
A lot of underscores____________is okay
___A lot of underscores____________is okay___
BetterEm will also ensure that smart mode breaks proper when an inner like token signifies an end.
Smart Break Example
This will all be bold __because of the placement of the center underscores.
This will all be bold __ because of the placement of the center asterisks.
This will NOT all be bold because of the placement of the center underscores.__
This will all be bold_ because the token count is less than that of the surrounding.
__This will all be bold __because of the placement of the center underscores.__
__This will all be bold __ because of the placement of the center underscores.__
__This will NOT all be bold__ because of the placement of the center underscores.__
__This will all be bold_ because of the token is less than that of the surrounding.__
BetterEm will allow non-smart emphasis to contain "floating" like tokens.
Floating Token Example
All will * be italic
All will *be italic
All will not be italic*
All will ** be italic
All will * be bold
All will *be bold
All will not* be bold**
All will not *be bold**
*All will * be italic*
*All will *be italic*
*All will not* be italic*
*All will not ** be italic*
**All will * be bold**
**All will *be bold**
**All will not*** be bold**
**All will not *** be bold**
Options
| Option | Type | Default | Description |
|---|---|---|---|
smart_enable | string | 'underscore' | A string that specifies whether smart should be enabled for all, asterisk, underscore, or none. |