Skip to content

add_md_toc

Note

Always use the FQCN (Fully Qualified Collection Name) arista.avd.add_md_toc when using this plugin.

Parse the input Markdown and add a Table of Contents between the toc_markers.

Synopsis

The filter is used in arista.avd.eos_designs to create a table of contents for Fabric Documentation.

The filter is also used in arista.avd.eos_cli_config_gen to create a table of contents for Device Documentation.

Requirements

The below requirements are needed on the host that executes this module.

  • md_toc

Parameters

Argument Type Required Default Value Restrictions Description
_input string True None Markdown to process.
skip_lines integer optional 0 Skip the first x lines when parsing the input Markdown.
toc_levels integer optional 3 How many levels of headings will be included in the TOC.
toc_marker string optional TOC will be inserted or updated between two of markers in the input Markdown.

Examples

---
tasks:
- name: Generate fabric documentation
  run_once: true
  delegate_to: localhost
  check_mode: no
  copy:
    content: "{{ lookup('template','documentation/fabric-documentation.j2') | arista.avd.add_md_toc(skip_lines=3) }}"
    dest: "{{ fabric_dir }}/{{ fabric_name }}-documentation.md"
    mode: "0o664"

Return Values

Name Type Description
_value string Markdown with TOC inserted between the toc_markers.

Authors

  • Arista Ansible Team (@aristanetworks)