Skip to content

v3.2: ports from 3.3 (June/July 2026) #4510

v3.2: ports from 3.3 (June/July 2026)

v3.2: ports from 3.3 (June/July 2026) #4510

name: validate-markdown
# Author: @MikeRalphson
# Issue: https://github.com/OAI/OpenAPI-Specification/issues/2130
# This workflow validates markdown files in the project root.
# It also validates the work-in-progress specification file src/oas.md with slightly different rules.
# run this on pull requests (which includes pushes to their head branch)
on:
- pull_request
jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7 # checkout repo content
- uses: actions/setup-node@v6 # setup Node.js
with:
node-version: "24.x"
- name: Lint work-in-progress spec
run: npx --yes markdownlint-cli2 --config spec.markdownlint.yaml src/oas.md
- name: Lint other files
run: npx --yes markdownlint-cli2 *.md