ディレクティブというのは、さまざまな用途で使用される、マークアップの要素です。ディレクティブは引数、オプション、コンテンツを持つことができます。ディレクティブ名の末尾の2つのコロンの後ろに書かれます。それぞれのディレクティブごとに、引数を持つか、持つ場合はいくつか、というのが決まっています。引数の後ろに、フィールドリストの形式で書かれます。いうのがオプションにあたります。オプションのや引数から空行を一行空けた、その後の内容になります。ディレクティブごとにコンテンツを書けるかどうか、何を書くのか、というのが決まっています。