Skip to content

Add context links to Markdown version of pages for AI agents #2557

@jancurn

Description

@jancurn

When you open a docs page in browser (e.g. https://docs.apify.com/platform/actors/running), you see:

  • Left menu - parent pages and sub-pages
  • Breadcrumbs
  • Prev/next page button at the bottom

All these links give you a context where to find related content.

On the other hand, when you open the Markdown version (e.g. https://docs.apify.com/platform/actors/running.md), you only get the actual content, with no navigation context.

Let's get the navigation also to Markdown, e.g. as a structured skill-like header on top:

---
Page: [Running Actors](https://docs.apify.com/platform/actors/running.md)
Parents:
- [Apify documentation](https://docs.apify.com/llms.txt)
- [Apify Platform documentation](https://docs.apify.com/platform.md)
- [Actors](https://docs.apify.com/platform/actors.md)
Children: 
- [Actors in Store](https://docs.apify.com/platform/actors/running/actors-in-store.md)
  - ...
- [Input and output](https://docs.apify.com/platform/actors/running/input-and-output.md)
- ...
--- 

The children should contain the full hierarchical sub-menu of all content underneath the current page, so the AI agent can find any relevant sub-content in the next turn.

Make sure to skip this new heading in llms-full.txt, as that one already contains everything, so that we don’t confuse the agent.

Metadata

Metadata

Assignees

No one assigned

    Labels

    UXUser experience issuet-webIssues with this label are in the ownership of the web team.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions