---
layout: default
title: Installation
description: Instructions on how to install the league/commonmark library
redirect_from: /installation/
---

# Installation

The recommended installation method is via Composer.

In your project root just run:

~~~bash
composer require league/commonmark:^1.5
~~~

Ensure that you’ve set up your project to [autoload Composer-installed packages](https://getcomposer.org/doc/00-intro.md#autoloading).

## Versioning

[SemVer](http://semver.org/) will be followed closely.  **It's highly recommended that you use [Composer's caret operator](https://getcomposer.org/doc/articles/versions.md#caret) to ensure compatibility**; for example: `^1.5`.  This is equivalent to `>=1.5 <2.0`.
