name: Check Markdown links

on:
  push:
    branches: [ "main" ]
    paths: "**.md"
  pull_request:
    branches: [ "main" ]
    paths: "**.md"

permissions:
  contents: read

jobs:
  markdown-link-check:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1

      - name: Markup Link Checker (mlc)
        uses: becheran/mlc@7ec24825cefe0c9c8c6bac48430e1f69e3ec356e # v1.2.0
        with:
          # Ignore DocFX cross-reference links (xref:) that mlc cannot check.
          # Ignore DocFX snippet inclusion links.
          # Do not warn for learn.microsoft.com locale redirects.
          # Do not warn for modelcontextprotocol.io homepage/spec redirects.
          args: >-
            --ignore-links "xref:*"
            --ignore-links "*samples/*?name=snippet_*"
            --do-not-warn-for-redirect-to "https://learn.microsoft.com/en-us/*"
            --do-not-warn-for-redirect-to "https://modelcontextprotocol.io/*"
            ./docs