This page is a summary of most important non-obvious PasDoc features:
Support for arbitrary (even optional) CommentMarkers.
You can write entire pages using pasdoc syntax (like @-tags, see WritingDocumentation). This way you can use pasdoc like a simple document creation tool. See IntroductionAndConclusion.
You can easily add search box to your documentation, just pass --use-tipue-search CommandLine option.
GraphVizSupport allows PasDoc to easily incorporate classes inheritance and unit dependency graphs in the documentation.
--auto-link CommandLine option allows you to avoid writing @link tags everywhere.
--auto-abstract CommandLine option allows you to avoid writing @abstract tags everywhere.