---
layout: default
title: Strikethrough Extension
description: The StrikethroughExtension intelligently converts ASCII quotes, dashes, and ellipses to their Unicode equivalents
redirect_from:
  - /extensions/strikethrough/
  - /2.0/extensions/strikethrough/
  - /2.1/extensions/strikethrough/
  - /2.2/extensions/strikethrough/
  - /2.3/extensions/strikethrough/
  - /2.4/extensions/strikethrough/
  - /2.5/extensions/strikethrough/
  - /2.6/extensions/strikethrough/
  - /2.7/extensions/strikethrough/
---

# Strikethrough Extension

_(Note: this extension is included by default within [the GFM extension](/2.x/extensions/github-flavored-markdown/))_

This extension adds support for GFM-style strikethrough syntax.  It allows users to use `~~` in order to indicate text that should be rendered within `<del>` tags.

## Installation

This extension is bundled with `league/commonmark`. This library can be installed via Composer:

```bash
composer require league/commonmark
```

See the [installation](/2.x/installation/) section for more details.

## Usage

This extension can be added to any new `Environment`:

```php
use League\CommonMark\Environment\Environment;
use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
use League\CommonMark\Extension\Strikethrough\StrikethroughExtension;
use League\CommonMark\MarkdownConverter;

// Define your configuration, if needed
$config = [];

// Configure the Environment with all the CommonMark parsers/renderers
$environment = new Environment($config);
$environment->addExtension(new CommonMarkCoreExtension());

// Add this extension
$environment->addExtension(new StrikethroughExtension());

// Instantiate the converter engine and start converting some Markdown!
$converter = new MarkdownConverter($environment);
echo $converter->convert('This extension is ~~really good~~ great!');
```
