In this example project the article sources are located in the articles folder (this can be changed in the configuration). The name of the source files has to end in either .mmd or .txt (see this post for an explanation).

The file’s basename (without the extension) will be used as the article’s slug, which will then be used to create the URL of its single article page. The file name may start with one or more digits (0–9) followed by a dash, this prefix will not be included in the slug, but may be used to sort the files on the filesystem.

For example, this article’s source file is called:

003-source-path.mmd

So the slug for the article will be:

source-path

The directory an article source is located in (relative to the articles directory) will be used as the article’s category (see here). This, too, can be changed in the configuration, you could — for example — use the directory as tag, you could even use the topmost directory as tag and subdirectories as category, or simply ignore any directories.

All meta data extracted from the file name and/or path may be overridden by meta data included in the file.