$$Include{docs/siteMacros.textCarver}

# Installing and Running TextCarver
TextCarver is a node module. If you aren’t already comfortable using node, you’ll probably be happier waiting for a later version of TextCarver.

### Installation
$$exampleSimple{}
npm install -g textcarver
$$endExample{}

### Running
$$exampleSimple{}
textcarver sourcefile.md
$$endExample{}

We recommend using .md files for simple source files and .textcarver for files that contain extensive TextCarver code.

### Under the hood
TextCarver performs two separate passes on each file:

* The first pass interprets the TextCarver language.
* The second pass interprets Markdown using the CommonMark library.

If you like, you can run only one of the passes:

$$exampleSimple{}
textcarver -firstpass sourcefile.md
textcarver -secondpass sourcefile.md
$$endExample{}



[Next: TextCarver basics](1bBasics.html)