A Parakeet page is any file which results in a HTML file being produced.
A file with the
.page extension is interpreted as consisting of an optional header and a body. The body part contains the markup of the page.
The header can be used to set meta-data about the page, for example, the navigation title or categories. All data in the header can be set in the associated config file, but being able to specify everything in one file is more convienant.
The header data is set in the format of
key: value. The header section ends when the first non-blank line not in that format is seen, or when a line of dashes is seen.
A naked page is a file which only contains the markup and has no header section.
A file named
.markdown) will be intepreted as a naked page containing Markdown data. Similarly a file named
.peanut will be treated as a naked page containing Peanut data.
In general I would recommend using
.page files to benefit from the header section.