list of children sub pages in the index.md body

[StefanoCecere]

hi
I couldn't find a native way to embed the list of all subpages
for example in page https://2050x.org/spazio/riferimenti/personaggi/ i would like just the list of subpages like in the navigation

is it possible without a custom plugin?

i know someone was asking the same for blog posts (to have a preview list in other pages)

thank you!

[squidfunk]

You could use a custom template for that page and iterate through all pages with:

<ul>
  {% for page in nav.pages %}
    <li>{{ page.title }}</li>
  {% endfor %}
</ul>

[StefanoCecere]

i already wrote some templates to have custom tables.. great.

you confirm that MkDocs doesn't allow to inject "widgets" or shortcodes (like Hugo calls tham) directly in the .md file, right?
we have to go with an external page template...

[squidfunk]

You can add your own custom shortcodes with hooks, similar to how we do it in our docs:

mkdocs-material/src/overrides/hooks/shortcodes.py

Lines 40 to 70 in b777690

	# Replace callback
	def replace(match: Match):
	type, args = match.groups()
	args = args.strip()
	if type == "version":
	if args.startswith("insiders-"):
	return _badge_for_version_insiders(args, page, files)
	else:
	return _badge_for_version(args, page, files)
	elif type == "sponsors": return _badge_for_sponsors(page, files)
	elif type == "flag": return flag(args, page, files)
	elif type == "option": return option(args)
	elif type == "setting": return setting(args)
	elif type == "feature": return _badge_for_feature(args, page, files)
	elif type == "plugin": return _badge_for_plugin(args, page, files)
	elif type == "extension": return _badge_for_extension(args, page, files)
	elif type == "utility": return _badge_for_utility(args, page, files)
	elif type == "example": return _badge_for_example(args, page, files)
	elif type == "default":
	if args == "none": return _badge_for_default_none(page, files)
	elif args == "computed": return _badge_for_default_computed(page, files)
	else: return _badge_for_default(args, page, files)
	# Otherwise, raise an error
	raise RuntimeError(f"Unknown shortcode: {type}")
	# Find and replace all external asset URLs in current page
	return re.sub(
	r"<!-- md:(\w+)(.*?) -->",
	replace, markdown, flags = re.I | re.M
	)