

BetterEm

概观

BetterEm is an extension that aims to improve emphasis (bold and italic) handling. 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).

Reminder

Remember to read the Usage Notes for information that may be relevant when using this extension!

差异

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

* Won't highlight *

*Will highlight*

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 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___

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 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.__

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.

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 not ** 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**

选项

选项	类型	默认	描述
smart_enable	string	'underscore'	A string that specifies whether smart should be enabled for all, asterisk, underscore, or none.