https://github.com/vdjagilev/nmap2md
A little utility to convert nmap xml results to markdown tables
https://github.com/vdjagilev/nmap2md
markdown nmap python3 scan security xml
Last synced: 6 months ago
JSON representation
A little utility to convert nmap xml results to markdown tables
- Host: GitHub
- URL: https://github.com/vdjagilev/nmap2md
- Owner: vdjagilev
- License: mit
- Created: 2019-06-29T15:56:21.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-03-30T15:04:56.000Z (over 3 years ago)
- Last Synced: 2025-03-26T04:33:40.726Z (7 months ago)
- Topics: markdown, nmap, python3, scan, security, xml
- Language: Python
- Size: 23.4 KB
- Stars: 68
- Watchers: 2
- Forks: 13
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# nmap2md
A little utility to convert nmap XML results to markdown tables.
## Usage
Download application, you can use git for it:
```
git clone git@github.com:vdjagilev/nmap2md.git
cd nmap2md
```
Example which parses nmap XML and outputs Markdown tables
```
./nmap2md.py test.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 **r**ow **c**ells
* 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 **h**eader **s**ize. 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)