WP Manifestindependent plugin directory
manifest / utilities / kiss-markdown-viewer

KISS-markdown-viewer

Simple plugin to load and render .md files in admin pages or front-end. Supports headlines, bold, italics, and hyperlinks. Provides API for other plugins to integrate and graceful fallback.

by KISS Plugins · github.com/kissplugins/kiss-markdown-viewer · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/kissplugins/kiss-markdown-viewer/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/kissplugins/kiss-markdown-viewer ↗

A lightweight “Keep It Simple, Stupid” Markdown viewer for WordPress. Render .md files in the admin area or on the front end with minimal setup. Other plugins can hook in or fall back if it’s not installed.

Table of Contents

  1. Installation
  2. Usage
  3. Developer API
  4. Shortcode
  5. Filters & Actions
  6. Changelog
  7. Upgrade Notice
  8. License

Installation

  1. Upload the plugin folder (kiss-markdown-viewer/) to your /wp-content/plugins/ directory.
  2. Ensure the vendor/parsedown directory is present (bundled or via Composer).
  3. Activate KISS-markdown-viewer through the Plugins screen in WordPress.

Usage

Admin Preview

  • Navigate to KISS Markdown Viewer → MD Preview to preview any .md file in the plugin folder.

Front-End Shortcode

echo do_shortcode( '[kiss_mdv_render file="docs/my-doc.md"]' );

Or directly in post/page content:

[kiss_mdv_render file="docs/my-doc.md"]

Developer API

Programmatically render Markdown:

if ( function_exists( 'kiss_mdv_render_file' ) ) {
    $html = kiss_mdv_render_file( '/path/to/file.md' );
} else {
    // Fallback to plain text rendering
    $markdown_file = '/path/to/file.md';
    if ( file_exists( $markdown_file ) ) {
        $content = file_get_contents( $markdown_file );
        $html    = '<pre>' . esc_html( $content ) . '</pre>';
    } else {
        $html = 'Markdown file not found.';
    }
}

Shortcode

  • Tag: [kiss_mdv_render file="relative/path/to.md"]

  • Attributes:

    • file (required) – Path relative to the plugin root directory.

Filters & Actions

  • Filter: kiss_mdv_renderer_html Modify the rendered HTML before output:

    add_filter( 'kiss_mdv_renderer_html', function( $html, $file ) {
    // Alter $html as needed
    return $html;
}, 10, 2 );

  • Suggested Action: kiss_mdv_renderer_before_render Hook before parsing:

    add_action( 'kiss_mdv_renderer_before_render', function( $file ) {
    // Pre-render logic
} );

Changelog

1.0.1

  • Updated the example API call in the documentation to include a fallback that displays the Markdown file as plain text.

1.0.0

  • Initial release: basic parsing, admin preview, shortcode, and API hooks.

Upgrade Notice

1.0.0

Initial stable version.

License

This plugin is distributed under the terms of the GNU General Public License v2.0. See the license text for details.