OS Manuals

/usr/bin/terraform-docs

Generate documentation from Terraform modules in various output formats

From terraform-docs 0.24.0-r15 (os), captured 2026-11-05 by running terraform-docs --help (exit 0). permalink

Also provided by 1 other package version
A utility to generate documentation from Terraform modules in various output formats

Usage:
  terraform-docs [PATH] [flags]
  terraform-docs [command]

Available Commands:
  asciidoc    Generate AsciiDoc of inputs and outputs
  completion  Generate shell completion code for the specified shell (bash, zsh, fish)
  help        Help about any command
  json        Generate JSON of inputs and outputs
  markdown    Generate Markdown of inputs and outputs
  pretty      Generate colorized pretty of inputs and outputs
  tfvars      Generate terraform.tfvars of inputs
  toml        Generate TOML of inputs and outputs
  version     Print the version number of terraform-docs
  xml         Generate XML of inputs and outputs
  yaml        Generate YAML of inputs and outputs

Flags:
  -c, --config string               config file name (default ".terraform-docs.yml")
      --footer-from string          relative path of a file to read footer from (default "")
      --header-from string          relative path of a file to read header from (default "main.tf")
  -h, --help                        help for terraform-docs
      --hide strings                hide section [all, data-sources, footer, header, inputs, modules, outputs, providers, requirements, resources]
      --lockfile                    read .terraform.lock.hcl if exist (default true)
      --output-check                check if content of output file is up to date (default false)
      --output-file string          file path to insert output into (default "")
      --output-mode string          output to file method [inject, replace] (default "inject")
      --output-template string      output template (default "<!-- BEGIN_TF_DOCS -->\n{{ .Content }}\n<!-- END_TF_DOCS -->")
      --output-values               inject output values into outputs (default false)
      --output-values-from string   inject output values from file into outputs (default "")
      --read-comments               use comments as description when description is empty (default true)
      --recursive                   update submodules recursively (default false)
      --recursive-exclude strings   exclude directories from recursive update
      --recursive-include-main      include the main module (default true)
      --recursive-path string       submodules path to recursively update (default "modules")
      --show strings                show section [all, data-sources, footer, header, inputs, modules, outputs, providers, requirements, resources]
      --sort                        sort items (default true)
      --sort-by string              sort items by criteria [name, required, type] (default "name")
  -v, --version                     version for terraform-docs

Use "terraform-docs [command] --help" for more information about a command.
Options (21)
OptionDescriptionSource
-c, --config stringconfig file name (default ".terraform-docs.yml")help
--footer-from stringrelative path of a file to read footer from (default "")help
--header-from stringrelative path of a file to read header from (default "main.tf")help
-h, --helphelp for terraform-docshelp
--hide stringshide section [all, data-sources, footer, header, inputs, modules, outputs, providers, requirements, resources]help
--lockfileread .terraform.lock.hcl if exist (default true)help
--output-checkcheck if content of output file is up to date (default false)help
--output-file stringfile path to insert output into (default "")help
--output-mode stringoutput to file method [inject, replace] (default "inject")help
--output-template stringoutput template (default "<!-- BEGIN_TF_DOCS -->\n{{ .Content }}\n<!-- END_TF_DOCS -->")help
--output-valuesinject output values into outputs (default false)help
--output-values-from stringinject output values from file into outputs (default "")help
--read-commentsuse comments as description when description is empty (default true)help
--recursiveupdate submodules recursively (default false)help
--recursive-exclude stringsexclude directories from recursive updatehelp
--recursive-include-maininclude the main module (default true)help
--recursive-path stringsubmodules path to recursively update (default "modules")help
--show stringsshow section [all, data-sources, footer, header, inputs, modules, outputs, providers, requirements, resources]help
--sortsort items (default true)help
--sort-by stringsort items by criteria [name, required, type] (default "name")help
-v, --versionversion for terraform-docshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.