Skip to content
check-square

GitHub Action

Markdown SEO Check

v1.1.5 Latest version

Markdown SEO Check

check-square

Markdown SEO Check

Check markdown files

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Markdown SEO Check

uses: zentered/markdown-seo-check@v1.1.5

Learn more about this action in zentered/markdown-seo-check

Choose a version

Markdown SEO Check

Workflow Integration Test status Unit Test status Unit Test status Semantic Release bagde Semantic Release bagde

Validate markdown files with SEO best practices. Creates a pull request comment and fails if conditions are not met.

Table of Contents

Usage

If your repo is public and you have pull requests from forks, pull_request_target is required, as this Action creates a comment on a Pull Request and therefore requires read/write permissions. Read more about the pull_request_target trigger here. If your repo is private, you can change this to pull_request and remove the ref in the checkout action.

name: check

on: pull_request_target

jobs:
  seocheck:
    name: Markdown SEO Check
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          ref: ${{ github.event.pull_request.head.sha }}
      - name: Markdown SEO Check
        uses: zentered/markdown-seo-check@v1.1.0
        with:
          max_title_length: 70
          max_description_length: 150
          max_slug_length: 100
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Inputs

Name Requirement Default Description
includes optional {*.md,*.mdx} Glob to include specific files or folders. See glob-to-regexp usage for examples.
excludes optional '' Glob to exclude files or folders
max_title_length required 70 Maximum length of page title
max_description_length required 150 Maximum length of description
max_slug_length required 100 Maximum length of slug

Outputs

screenshot of github comment

Contributing

See CONTRIBUTING.

License

See LICENSE.