Hi,
At $DAYJOB, we keep our IT documentation in Markdown files for easy offline access. Part of that documentation requires us to write justifications for any firewall rule. It’s a manual-heavy task, but I wrote a converter [1] tool that ingests pfSense (and I’m assuming OpenSense) XML and auto-generates Markdown files based on the interface names. Each file contains the rules for that interface.
It also generates an alias.md file that holds all the aliases along with if they are used. Sometimes I forget to clean up aliases that are no longer used, and this alias.md file helps identify them.
Merge requests/ issues welcome.