Use an HTML comment to list links of the current page's children or siblings.
Common usage is for content sites utilizing WordPress as a simple CMS. Some content hierarchies call for an Overview page followed by multiple subpages, for example, a Services page.
Use the following shortcodes to list children and or siblings of the current page:
Alphabetical listing of current page's children:
[list_children sort_column="page_title" sort_order="asc"]
List of current page's siblings, ordered by menu order (descending):
[list_siblings sort_column="menu_order" sort_order="desc"]
You can use a majority of the attributes from the wp_list_pages() call:
http://codex.wordpress.org/Function_Reference/wp_list_pages
The following will no longer work (deprecated):
<ul>
<!--list_children()-->
</ul>