Pymdown Extensions

Common errors

Warnings

Install compatibility verified last tested: 2026-05-12 v10.21.2 (up to date)

Imports

• markdown.Markdown

  import markdown
  html = markdown.Markdown(extensions=['pymdownx.superfences', 'pymdownx.highlight']).convert(md_text)

  Pymdown Extensions are loaded by their module name (e.g., 'pymdownx.superfences') into the `extensions` list of `markdown.Markdown`.

Quickstart last tested: 2026-04-24

Initialize a Markdown converter with `pymdown-extensions` by listing their names (e.g., `pymdownx.superfences`, `pymdownx.highlight`) in the `extensions` argument. The example demonstrates basic Markdown conversion with code block highlighting and emoji support.

import markdown

md_text = '''
# Hello Pymdown!

This is a simple markdown with `inline code`.

```python
# SuperFences and Highlight example
def greet(name):
    print(f"Hello, {name}!")

greet("World")
```
''')

# To use Pymdown Extensions, pass their names (prefixed with 'pymdownx.')
# to the 'extensions' argument of markdown.Markdown.
# 'superfences' allows nested code blocks, and 'highlight' provides syntax highlighting.
html = markdown.Markdown(
    extensions=[
        'pymdownx.superfences',
        'pymdownx.highlight',
        'pymdownx.emoji'
    ]
).convert(md_text)

print(html)