# Twemoji Legacy API (V1)
## Usage
### CDN Support
The folks over at [MaxCDN](https://www.maxcdn.com) have graciously provided CDN support.
Use the following in the `` tag of your HTML document(s):
```html
```
This guarantees that you are using the V1 version of the library.
### Download
If instead you want to download a specific version, please look at the `gh-pages` branch, where you will find the built assets for our legacy versions.
## API
Following are all the methods exposed in the `twemoji` namespace.
### twemoji.parse( ... )
This is the main parsing utility and has 3 overloads per parsing type.
There are mainly two kinds of parsing: [string parsing](https://github.com/twitter/twemoji#string-parsing) and [DOM parsing](https://github.com/twitter/twemoji#dom-parsing).
Each of them accepts a callback to generate an image source or an options object with parsing info.
Here is a walkthrough of all parsing possibilities:
#### string parsing
Given a generic string, replaces all emoji with an `![]()
` tag.
While this can be used to inject emoji via image tags in `innerHTML`, please note that this method does not sanitize the string or prevent malicious code from being executed. As an example, if the text contains a `