{
    "mode": "man",
    "parameter": "git-column",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/git-column/1/json",
    "generated": "2026-09-06T11:03:59Z",
    "synopsis": "git column [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>]\n[--indent=<string>] [--nl=<string>] [--padding=<n>]",
    "sections": {
        "NAME": {
            "content": "git-column - Display data in columns\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "git column [--command=<name>] [--[raw-]mode=<mode>] [--width=<width>]\n[--indent=<string>] [--nl=<string>] [--padding=<n>]\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "This command formats the lines of its standard input into a table with multiple columns. Each\ninput line occupies one cell of the table. It is used internally by other git commands to\nformat output into columns.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "--command=<name>\nLook up layout mode using configuration variable column.<name> and column.ui.\n\n--mode=<mode>\nSpecify layout mode. See configuration variable column.ui for option syntax in git-\nconfig(1).\n\n--raw-mode=<n>\nSame as --mode but take mode encoded as a number. This is mainly used by other commands\nthat have already parsed layout mode.\n\n--width=<width>\nSpecify the terminal width. By default git column will detect the terminal width, or fall\nback to 80 if it is unable to do so.\n\n--indent=<string>\nString to be printed at the beginning of each line.\n\n--nl=<string>\nString to be printed at the end of each line, including newline character.\n\n--padding=<N>\nThe number of spaces between columns. One space by default.\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "Format data by columns:\n\n$ seq 1 24 | git column --mode=column --padding=5\n1      4      7      10     13     16     19     22\n2      5      8      11     14     17     20     23\n3      6      9      12     15     18     21     24\n\n\nFormat data by rows:\n\n$ seq 1 21 | git column --mode=row --padding=5\n1      2      3      4      5      6      7\n8      9      10     11     12     13     14\n15     16     17     18     19     20     21\n\n\nList some tags in a table with unequal column widths:\n\n$ git tag --list 'v2.4.*' --column=row,dense\nv2.4.0  v2.4.0-rc0  v2.4.0-rc1  v2.4.0-rc2  v2.4.0-rc3\nv2.4.1  v2.4.10     v2.4.11     v2.4.12     v2.4.2\nv2.4.3  v2.4.4      v2.4.5      v2.4.6      v2.4.7\nv2.4.8  v2.4.9\n\n",
            "subsections": []
        },
        "CONFIGURATION": {
            "content": "Everything below this line in this section is selectively included from the git-config(1)\ndocumentation. The content is the same as what’s found there:\n\ncolumn.ui\nSpecify whether supported commands should output in columns. This variable consists of a\nlist of tokens separated by spaces or commas:\n\nThese options control when the feature should be enabled (defaults to never):\n\nalways\nalways show in columns\n\nnever\nnever show in columns\n\nauto\nshow in columns if the output is to the terminal\n\nThese options control layout (defaults to column). Setting any of these implies always if\nnone of always, never, or auto are specified.\n\ncolumn\nfill columns before rows\n\nrow\nfill rows before columns\n\nplain\nshow in one column\n\nFinally, these options can be combined with a layout option (defaults to nodense):\n\ndense\nmake unequal size columns to utilize more space\n\nnodense\nmake equal size columns\n\ncolumn.branch\nSpecify whether to output branch listing in git branch in columns. See column.ui for\ndetails.\n\ncolumn.clean\nSpecify the layout when listing items in git clean -i, which always shows files and\ndirectories in columns. See column.ui for details.\n\ncolumn.status\nSpecify whether to output untracked files in git status in columns. See column.ui for\ndetails.\n\ncolumn.tag\nSpecify whether to output tag listings in git tag in columns. See column.ui for details.\n",
            "subsections": []
        },
        "GIT": {
            "content": "Part of the git(1) suite\n\nGit 2.43.0                                   07/02/2025                                GIT-COLUMN(1)",
            "subsections": []
        }
    },
    "summary": "git-column - Display data in columns",
    "flags": [],
    "examples": [
        "Format data by columns:",
        "$ seq 1 24 | git column --mode=column --padding=5",
        "1      4      7      10     13     16     19     22",
        "2      5      8      11     14     17     20     23",
        "3      6      9      12     15     18     21     24",
        "Format data by rows:",
        "$ seq 1 21 | git column --mode=row --padding=5",
        "1      2      3      4      5      6      7",
        "8      9      10     11     12     13     14",
        "15     16     17     18     19     20     21",
        "List some tags in a table with unequal column widths:",
        "$ git tag --list 'v2.4.*' --column=row,dense",
        "v2.4.0  v2.4.0-rc0  v2.4.0-rc1  v2.4.0-rc2  v2.4.0-rc3",
        "v2.4.1  v2.4.10     v2.4.11     v2.4.12     v2.4.2",
        "v2.4.3  v2.4.4      v2.4.5      v2.4.6      v2.4.7",
        "v2.4.8  v2.4.9"
    ],
    "see_also": [],
    "tldr": {
        "source": "official",
        "description": "Display data in columns.",
        "examples": [
            {
                "description": "Format `stdin` as multiple columns",
                "command": "ls | git column --mode={{column}}"
            },
            {
                "description": "Format `stdin` as multiple columns with a maximum width of `100`",
                "command": "ls | git column --mode=column --width={{100}}"
            },
            {
                "description": "Format `stdin` as multiple columns with a maximum padding of `30`",
                "command": "ls | git column --mode=column --padding={{30}}"
            }
        ]
    }
}