thethinggoesskra / nmap2md_for_zettler

A little utility to convert nmap xml results to markdown tables

nmap2md

A little utility to convert nmap XML results to markdown tables for zettler.

Usage

Download application, you can use git for it:

git clone https://github.com/TheThingGoesSkra/nmap2md_for_zettler
cd nmap2md_for_zettler

Launch nmap scan and export results in xml file:

sudo nmap 10.11.1.0/24 --top-ports=1000 -oX nmap_results.xml

Example which parses nmap XML and create subnet tree using markdown files

./nmap2md.py nmap_results.xml

Options

Columns and row cells definition should be divided by ,.

• -c is used to define columns. It is possible to write there anything
  • Default: Port,State,Service,Version
• --rc is used to define row cells
  • Default: [port.number]/[port.protocol],[state],[service.name],[service.product] [service.version]
  • Available options:
    • [port.number] Port number (80)
    • [port.protocol] Port protocol (TCP)
    • [state] State (open)
    • [service.name] Name of the used service (http)
    • [service.product] Type of product used on that service (Apache httpd)
    • [service.version] Version of the product (2.2.14)
• --hs is header size. Size variations: from 1 to 6.
  • Default: 0 (disabled)
• --sort is for sorting.
  • Default: Port;asc
  • Can use any column that is defined in -c
  • asc & desc options, if none is provided: asc by default
• --print-empty some port scanning results are empty and those are not displayed. However if there is a need to print empty sets, this option allows this.
  • Default: False

Output example

An example with many options and MD support in table cells (service values are italic). XML file was taken from https://nmap.org/book/output-formats-xml-output.html and this command was used:

./nmap2md.py test.xml -c "Port,State,Service,Version" --hs 4 --rc "[port.number]/[port.protocol],[state],*[service.name]*,[service.product] [service.version]"

74.207.244.221

Port	State	Service	Version
22/tcp	open	ssh	OpenSSH 5.3p1 Debian 3ubuntu7
80/tcp	open	http	Apache httpd 2.2.14

Contributors

Thanks to the listed contributors for fixing bugs/testing & adding new features:

• Brandon Hinkel (https://github.com/b4ndit)
• initinfosec (https://github.com/initinfosec)