{
    "mode": "man",
    "parameter": "fc-match",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/fc-match/1/json",
    "generated": "2026-06-13T22:09:56Z",
    "synopsis": "fc-match  [ -asvVh ]  [ --all ]  [ --sort ]  [ --verbose ]  [  [ -f format ]  [ --format for‐\nmat ]  ]  [ --version ]  [ --help ]\n[ pattern  [ element... ]   ]",
    "sections": {
        "NAME": {
            "content": "fc-match - match available fonts\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "fc-match  [ -asvVh ]  [ --all ]  [ --sort ]  [ --verbose ]  [  [ -f format ]  [ --format for‐\nmat ]  ]  [ --version ]  [ --help ]\n\n[ pattern  [ element... ]   ]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "fc-match matches pattern (empty pattern by default)  using  the  normal  fontconfig  matching\nrules  to  find the best font available. If --sort is given, the sorted list of best matching\nfonts is displayed.  The --all option works like --sort except that no pruning is done on the\nlist of fonts.\n\nIf  any  elements  are specified, only those are printed.  Otherwise short file name, family,\nand style are printed, unless verbose output is requested.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "This program follows the usual GNU command line syntax, with long options starting  with  two\ndashes (`-'). A summary of options is included below.\n",
            "subsections": [
                {
                    "name": "-a",
                    "content": "",
                    "flag": "-a"
                },
                {
                    "name": "-s",
                    "content": "",
                    "flag": "-s"
                },
                {
                    "name": "-v",
                    "content": "provided.\n",
                    "flag": "-v"
                },
                {
                    "name": "-f",
                    "content": "",
                    "flag": "-f"
                },
                {
                    "name": "-V",
                    "content": "",
                    "flag": "-V"
                },
                {
                    "name": "-h",
                    "content": "pattern\nDisplays fonts matching pattern (uses empty pattern by default).\n\nelement\nIf set, the element property is displayed for matching fonts.\n",
                    "flag": "-h"
                }
            ]
        },
        "SEE ALSO": {
            "content": "fc-list(1) FcFontMatch(3)  FcFontSort(3)  FcPatternFormat(3)  fc-cat(1)  fc-cache(1)  fc-pat‐‐\ntern(1) fc-query(1) fc-scan(1)\n\nThe fontconfig user's guide, in HTML format: /usr/share/doc/fontconfig/fontconfig-user.html.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "This manual page was updated by Patrick Lam <plam@csail.mit.edu>.\n\n\n\nAug 13, 2008                                 FC-MATCH(1)",
            "subsections": []
        }
    },
    "summary": "fc-match - match available fonts",
    "flags": [
        {
            "flag": "-a",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-s",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-v",
            "long": null,
            "arg": null,
            "description": "provided."
        },
        {
            "flag": "-f",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-V",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-h",
            "long": null,
            "arg": null,
            "description": "pattern Displays fonts matching pattern (uses empty pattern by default). element If set, the element property is displayed for matching fonts."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "fc-list",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-list/1/json"
        },
        {
            "name": "FcFontMatch",
            "section": "3",
            "url": "https://www.chedong.com/phpMan.php/man/FcFontMatch/3/json"
        },
        {
            "name": "FcFontSort",
            "section": "3",
            "url": "https://www.chedong.com/phpMan.php/man/FcFontSort/3/json"
        },
        {
            "name": "FcPatternFormat",
            "section": "3",
            "url": "https://www.chedong.com/phpMan.php/man/FcPatternFormat/3/json"
        },
        {
            "name": "fc-cat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-cat/1/json"
        },
        {
            "name": "fc-cache",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-cache/1/json"
        },
        {
            "name": "tern",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/tern/1/json"
        },
        {
            "name": "fc-query",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-query/1/json"
        },
        {
            "name": "fc-scan",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-scan/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Match available fonts.",
        "examples": [
            {
                "description": "Return a sorted list of best matching fonts",
                "command": "fc-match {{-s|--sort}} '{{DejaVu Serif}}'"
            }
        ]
    }
}