YAML の `---`(ハイフン 3 つ)は何か?

ハイフン 3 個の行は、本来は「YAML 文書の分割」の意味である。 ∥ YAML - Wikipedia, the free encyclopedia

一つのファイル内に複数の YAML 文書を入れるために用いられるのだが、一文書しかない場合に「YAML 文書が始まること」を明示するために使われるそうだが…。?? 何かどうも。

もちろん無くてもよいのだが、文書s であることを明示するには付けた方が良いのかも知れない。

  • 読み始めで --- が出てきた → 1 つ以上の文書からなることが分かる
  • 読み始めで --- 以外が出てきた → 1 つの文書があることが分かる

といった感じか。

なお、... で、一連のストリームの終わりを意味する。