1つ以上のパターンが指定されている場合、fnmatch(3)を使用するか、文字通りに、後者の場合は完全に一致するか、スラッシュまで先頭から一致する少なくとも1つのパターンに一致する参照のみが表示されます。

`--stdin`が指定されている場合、パターンのリストは引数リストではなく標準入力から読み取られます。

デフォルトでは、このコマンドは`<pattern>`に一致するすべての参照を表示します。このオプションを使用すると、その数の参照を表示した後、停止します。

ソート対象のフィールド名です。値の降順でソートするには、接頭辞`-`を使用します。指定されていない場合、`refname`が使用されます。`--sort=<key>`オプションを複数回使用できます。その場合、最後のキーが主キーになります。

表示されている参照とその参照が指すオブジェクトから`%(fieldname)`を補間する文字列です。さらに、文字列リテラル`%%`は`%`として、`%xx`（`xx`は16進数）は16進コード`xx`の文字としてレンダリングされます。たとえば、`%00`は`\0`(NUL)に、`%09`は`\t`(TAB)に、`%0a`は`\n`(LF)に補間されます。

`--format`オプションで指定された色を尊重します。`<when>`フィールドは`always`、`never`、または`auto`のいずれかである必要があります（`<when>`がない場合、`always`が指定された場合と同じように動作します）。

指定されている場合、`%(fieldname)`プレースホルダーを置換する文字列は、指定されたホスト言語に適した文字列リテラルとして引用されます。これは、`eval`できるスクリプトレットを作成することを目的としています。

指定されたオブジェクトを指す参照のみをリストします。

その先端が指定されたコミット（指定されていない場合はHEAD）から到達可能な参照のみをリストします。

その先端が指定されたコミット（指定されていない場合はHEAD）から到達不可能な参照のみをリストします。

指定されたコミット（指定されていない場合はHEAD）を含む参照のみをリストします。

指定されたコミット（指定されていない場合はHEAD）を含まない参照のみをリストします。

参照のソートとフィルタリングは大文字と小文字を区別しません。

フォーマットされた参照で、フォーマットが空の文字列に展開される場合、改行を出力しません。

1つ以上のパターンが指定されている場合、除外されたパターンに一致しない参照のみが表示されます。マッチングは上記の`<pattern>`と同じルールで行われます。

通常の参照とは別に、ルート参照（HEADと疑似参照）をリストします。

参照の名前（$GIT_DIR/以降の部分）。参照のあいまいではない短い名前を追加するには、`:short`を付け加えます。オプションcore.warnAmbiguousRefsを使用して、厳密な省略形モードを選択します。`lstrip=<N>`（`rstrip=<N>`）を付け加えると、参照名の先頭（末尾）から``個のスラッシュで区切られたパスコンポーネントを削除します（例：`%(refname:lstrip=2)`は`refs/tags/foo`を`foo`に、`%(refname:rstrip=2)`は`refs/tags/foo`を`refs`に変更します）。`<N>`が負の数の場合、指定された端から必要な数のパスコンポーネントを削除して、`-<N>`個のパスコンポーネントを残します（例：`%(refname:lstrip=-2)`は`refs/tags/foo`を`tags/foo`に、`%(refname:rstrip=-1)`は`refs/tags/foo`を`refs`に変更します）。参照に十分なコンポーネントがない場合、正の``で削除すると結果は空の文字列になり、負の``で削除すると結果は完全な参照名になります。どちらもエラーではありません。

オブジェクトの種類（`blob`、`tree`、`commit`、`tag`）。

オブジェクトのサイズ（`git cat-file -s`が報告するサイズと同じ）。ディスク上のオブジェクトのサイズ（バイト単位）を取得するには、`:disk`を付け加えます。ディスク上のサイズについては、以下の`CAVEATS`セクションの注記を参照してください。

オブジェクト名（別名SHA-1）。オブジェクト名のあいまいではない省略形を追加するには、`:short`を付け加えます。目的の長さのオブジェクト名の省略形を追加するには、`:short=<length>`を付け加えます（最小長はMINIMUM_ABBREV）。一意のオブジェクト名を確保するために、長さは超える可能性があります。

これは、指定されたオブジェクトがデルタとして保存されている場合、そのデルタベースのオブジェクト名に展開されます。それ以外の場合は、ヌルオブジェクト名（すべてゼロ）に展開されます。

表示されている参照の上流と見なせるローカル参照の名前です。上記の`refname`と同様に、`:short`、`:lstrip`、`:rstrip`を尊重します。さらに、`[ahead N, behind M]`を表示する`:track`と、簡潔なバージョン`>`（先頭）、`<`（後方）、`< >`（先頭と後方）、または`=`（同期）を表示する`:trackshort`を尊重します。`unknown`な上流参照が見つかった場合は、`:track`に`[gone]`も出力されます。角かっこなしで追跡情報を表示するには（つまり「ahead N, behind M」）、`:track,nobracket`を付け加えます。

表示されている参照の`@{push}`場所を表すローカル参照の名前です。`upstream`と同様に、`:short`、`:lstrip`、`:rstrip`、`:track`、`:trackshort`、`:remotename`、`:remoteref`オプションを尊重します。`@{push}`参照が設定されていない場合は、空の文字列を出力します。

HEADが現在の参照（チェックアウトされたブランチ）と一致する場合は`*`、それ以外の場合は` `。

出力の色を変更します。`:<colorname>`が続きます。ここで、色名はgit-config[1]の「CONFIGURATION FILE」セクションの値で説明されています。たとえば、`%(color:bold red)`。

%(align:…​) と %(end) の間のコンテンツを左揃え、中央揃え、または右揃えします。「align:」の後に、カンマで区切られた任意の順序で `width=<width>` と `position=<position>` が続きます。ここで、`<position>` は left、right、middle のいずれかで、デフォルトは left です。`<width>` は配置を含むコンテンツの総長です。簡潔にするため、「width=」および/または「position=」プレフィックスを省略し、代わりに `<width>` と `<position>` をそのまま使用できます。例えば、`%(align:<width>,<position>)` のように。コンテンツの長さが幅よりも長い場合、配置は実行されません。`--quote` と一緒に使用すると、%(align:…​) と %(end) の間のすべてのものが引用符で囲まれますが、ネストされている場合は、最上位レベルのみが引用符で囲まれます。

%(if)…​%(then)…​%(end) または %(if)…​%(then)…​%(else)…​%(end) として使用されます。%(if) の後に値または文字列リテラルを持つアトムがある場合、%(then) の後のすべてが出力されます。そうでない場合、%(else) アトムが使用されていると、%(else) の後のすべてが出力されます。%(then) の前の文字列を評価する際には、スペースを無視します。これは、"*" または " " を出力する %(HEAD) アトムを使用し、*HEAD* ref にのみ *if* 条件を適用する場合に便利です。値を比較するために `:equals=<string>` または `:notequals=<string>` を追加して、%(if:…​) と %(then) アトムの間の値と指定された文字列を比較します。

指定されたシンボリック ref が参照する ref です。シンボリック ref でない場合、何も出力されません。上記の `refname` と同様に、` :short`、` :lstrip`、` :rstrip` オプションを尊重します。

コミットの GPG 署名。

有効な署名には "G"、無効な署名には "B"、有効性が不明な有効な署名には "U"、期限切れの有効な署名には "X"、期限切れのキーによって作成された有効な署名には "Y"、失効したキーによって作成された有効な署名には "R"、署名を検証できない場合（例：キーがない場合）には "E"、署名がない場合は "N" を表示します。

コミットの GPG 署名の署名者。

コミットの GPG 署名のキー。

コミットの GPG 署名のフィンガープリント。

コミットの GPG 署名のプライマリキーフィンガープリント。

コミットの GPG 署名の信頼レベル。出力可能な値は `ultimate`、`fully`、`marginal`、`never`、`undefined` です。

ref がリンクされたワークツリーでチェックアウトされている場合、そのワークツリーの絶対パス。そうでない場合は空文字列。

スペースで区切られた2つの整数。出力された ref とフォーマットで指定された `<committish>` を比較した場合の先頭と末尾のコミット数を示します。

最大1行で、`(<committish>)` が表示され、`<committish>` を生成したブランチの開始点として最も使用されている可能性のある ref を示します。この選択はヒューリスティックを使用して行われます。`<committish>` の先祖履歴の最初の親に含まれ、ref の先祖履歴の最初の親には含まれていないコミット数を最小化する ref を選択します。

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

git-describe[1] のような、人間が読める名前。記述できないコミットの場合は空文字列。`describe` 文字列の後にコロンと、1つ以上のカンマ区切りのオプションを付けることができます。

オブジェクトの生データサイズ。

コミットまたはタグメッセージのバイト数。

通常は1行であるメッセージの最初の段落は、コミットまたはタグメッセージの「件名」として扱われます。`contents:subject` の代わりに、`subject` フィールドを使用して同じ結果を得ることもできます。ファイル名に適した件名行には、`subject` に ` :sanitize` を追加します。

「件名」の後に続く、コミットまたはタグメッセージの残りの部分。

タグのオプションの GPG 署名。

メッセージの先頭 `N` 行。