Bugfixes and improvements on documentation

- Update the documentation of the list action
- Improve markdown formatting