jeffbuttars/Vimdown — Issue #4: Create a 'Book' from multiple input documents
Author: jeffbuttars
Created: 2012-03-03 23:13:55+00:00
State: open

Creating a 'Book' from multiple input documents will result in an output of one or more markdown documents. Part of the 'Book' creation will be the generation of a table of contents to make navigating the book's contents as easy as possible.

## Modes
There should be two 'Book' modes available, Directory or recursive mode and a flat mode.

### Directory mode
In directory mode the input can be a directory and Vimdown will recur through the directory parsing every file it can into a matching markdown and/or html output file. The output file structure will match the inputs. Input file lists can also be an explicit lists, but the output behavior will be the same as a directory input.

### Flat mode
In flat mode, the output will be a single markdown or html file. Input files can be given as an explicit list of files, stdin, or a directory. If a directory is given then Vimdown will recur through it, parsing every file it can.