Repository is archived
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Checks whether links/images in your Markdown files are valid.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.5
~> 2.6
>= 0
>= 0
~> 2.9

Runtime

 Project Readme

MarkdownProofer Build Status

A gem that validates your Markdown files. It uses HTML::Proofer under the hood to check whether links and images exist.

Setup

Requires Ruby 2.0+. Create the following files:

# Gemfile

source 'https://rubygems.org'

gem 'markdown_proofer', '~> 0.1.1'
gem 'rake'
# Rakefile

require 'rubygems'
require 'bundler'
Bundler.require(:default)

desc "Run Mardown validation for the repository"
task :validate_markdown do
  MarkdownProofer::RakeTask.run
end

task default: :validate_markdown

Configuration

MarkdownProofer::RakeTask.run accepts the following named parameters:

  • excludes – An Array of regular expressions. Any file paths that match will be excluded from validation. Defaults to excluding test-related files.
  • html_proofer – Options passed to HTML::Proofer. See the HTML::Proofer documentation.
  • path – The relative path to the file/directory that you want to validate. Defaults to the top-level directory.

Usage

bundle
bundle exec rake