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

Download application, you can use git for it:

git clone git@github.com:vdjagilev/nmap2md.git
pip3 install python-magic
cd nmap2md
nmap -A -T4 -oX test [target]

Example which parses nmap XML and outputs Markdown tables

./nmap2md.py test.xml

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)
• --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

Example was taken from https://nmap.org/book/output-formats-xml-output.html and used this command:

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

The following changes were made by initinfosec:

• Change default header value (--hs) from 0 to 4, so that the IP header is present in table by default without args
• Implement basic file checks and more friendly errors. Upon each error, a discrete message is displayed about the issue, and prints the usage info and exists. These checks include:
  • Checking for existance of file
  • Checking if filetype is XML
  • Checking validity of XML file (catch-all exception for ET parse errors)

Thanks to Brandon Hinkel (https://github.com/b4ndit) for fixing bugs and testing.