A versatile tool that converts NMAP XML scan results into multiple readable and analyzable formats including HTML, CSV, JSON, Markdown, Graphviz, SQLite, Excel, and D2 language.
A tool that allows you to convert NMAP results to html, csv, json, markdown, graphviz (dot), sqlite, excel and d2-lang. Simply put it's nmap converter.
This tool is primarily used by security professionals and vulnerability managers who need to transform raw NMAP scan outputs into more accessible and visually interpretable formats for reporting, analysis, or automation workflows. It simplifies the process of integrating NMAP results into various tools and formats suitable for different audiences or further processing.
The tool requires Go environment for installation and building. It is optimized for processing NMAP XML output and assumes familiarity with NMAP scanning. Using the tool as a library allows integration into custom Go applications for automated workflows. Users should ensure the input XML is valid NMAP output for accurate conversions.
Run `go install github.com/vdjagilev/nmap-formatter/v3@latest` to install the tool
Clone the repository with `git clone https://github.com/vdjagilev/nmap-formatter` (implied)
Change directory to the cloned repo: `cd nmap-formatter`
Build the project locally using `go build`nmap-formatter [html|csv|md|json|dot|sqlite|excel|d2] [path-to-nmap.xml] [flags]
Convert NMAP XML output to the specified format with optional flags
cat some.xml | nmap-formatter json
Read NMAP XML from stdin and convert it to JSON format
nmap-formatter html [path-to-nmap.xml] > some-file.html
Convert NMAP XML to HTML and save output to a file
nmap-formatter md [path-to-nmap.xml] > some-markdown.md
Convert NMAP XML to Markdown format and save to a file
nmap-formatter excel [path-to-nmap.xml]
Convert NMAP XML to Excel format
nmap-formatter json [path-to-nmap.xml]
Convert NMAP XML to JSON format
cat example.xml | nmap-formatter dot | dot -Tsvg > test.svg
Convert NMAP XML to Graphviz dot format and generate an SVG graph
cat example.xml | nmap-formatter sqlite --sqlite-dsn nmap.sqlite
Convert NMAP XML to SQLite database file
cat example.xml | nmap-formatter d2 | d2 - example.png
Convert NMAP XML to D2 language and then to PNG image
-f, --file [filename]
Flag to output result to a specified file instead of stdout
--skip-down-hosts
Flag to skip hosts that are down (default true)
--help
Display help message
--version
Display version information