Obsidian Stats logoObsidian Stats

Search Engine Optimization

by David V. Kimball
5
4
3
2
1
Score: 52/100
Install Code

Description

Plugin for Obsidian to ensure your public-facing notes are optimized for search engines and AI.

Reviews

No reviews yet.

Stats

2
stars
6,127
downloads
1
forks
79
days
7
days
7
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
97
commits

Latest Version

0.5.6
7 days ago

Changelog

Declare the TypeScript lib the code actually uses; bump to 0.5.6

The tsconfig declared lib: ["DOM", "ES5", "ES6", "ES7"], which stops at ES2016, but the code uses Object.values and Object.entries (ES2017), Array.flat (ES2019) and String.trimEnd (ES2019). It only type checked because @types/node carries a /// that pulls the newer lib in as a side effect.

Anything type checking this repo without that incidental injection sees those methods as untyped, so every call degrades to any and cascades. That is the source of the 113 no-unsafe-* findings on the community scorecard: compiling with types: [] and the old lib reproduces errors on exactly the lines the scorecard flagged (seo-checker.ts:122, csv-export.ts:49 and :136, results-display.ts:228, error-handler.ts:146).

Declaring lib: ["DOM", "ES2020"] matches what was already in effect, so this is a type-only change. esbuild sets its own target of es2018, so main.js is byte identical and the release stays reproducible.

Full Changelog: https://github.com/davidvkimball/obsidian-seo/compare/0.5.5...0.5.6

See all version on GitHub

README file from

Github

Search Engine Optimization

A comprehensive SEO analysis plugin for Obsidian that helps you optimize your notes for better discoverability and search engine ranking.

obsidian-seo-preview

Made for Vault CMS

Part of the Vault CMS project.

Features

SEO Auditing

  • Current Note Check - Analyze the currently open note
  • Vault-wide Scan - Check all notes in specified directories

Comprehensive SEO Checks

Content Quality
  • Content Length - Minimum word count threshold
  • Reading Level - Analyzes readability and complexity
  • Keyword Density - Optimal keyword usage
  • Duplicate Content - Detects similar content across notes
  • Duplicate Titles - Identifies duplicate titles across vault
  • Duplicate Descriptions - Finds duplicate meta descriptions
Technical SEO
  • Title Optimization - Proper title length and structure
  • Meta Description - Properties description validation
  • Keyword in Title - Ensures keywords appear in titles
  • Keyword in Description - Validates keyword presence in descriptions
  • Keyword in Slug - Checks keyword inclusion in filenames
  • Heading Structure - Proper H1-H6 hierarchy
  • Media Alt Text - Missing alt text detection for images, videos, embeds, etc.
  • Image Naming - SEO-friendly image filename patterns
Link Management
  • Broken Links - Detects non-existent internal links
  • Potentially Broken Links - Identifies links that may be broken
  • External Links - Validates external link accessibility
  • Naked Links - Identifies unformatted URLs
  • Broken Embeds - Detects potentially broken embedded content

User Experience

  • Flexible Sorting - Sort by issues, warnings, or filename
  • One-click Navigation - Jump directly to problematic files
  • Caching - Fast subsequent scans with intelligent cache management
  • Configurable Settings - Customize all checks and thresholds

Commands

Command Description
Open current note audit Open the current note audit panel
Open vault audit Open the vault-wide audit panel
Run current note audit Open panel and run audit on current note
Run vault audit Open panel and run audit on all notes

SEO Score System

The plugin uses a weighted scoring system that prioritizes critical SEO factors:

  • Critical Issues (10x weight): Broken links, missing titles
  • Important Issues (5x weight): Missing alt text, meta descriptions
  • Moderate Issues (3x weight): Content length, readability
  • Minor Issues (1x weight): Warnings and notices

Score Range: 40-100 (40 = needs work, 100 = excellent)

Usage

Quick Current Note Check

  1. Open any markdown file
  2. Use command "Run current note audit"
  3. Review issues, warnings, and notices

Vault-wide Analysis

  1. Configure scan directories in settings
  2. Use command "Run vault audit"
  3. Review comprehensive analysis with sorting options
  4. Click any file to open and fix issues

Performance Optimization

  • First scan builds cache (slower)
  • Subsequent scans use cache (much faster)
  • Cache automatically expires after 24 hours

Installation

Community Plugins Search

  1. In Obsidian, go to Settings > Community plugins (enable it if you haven't already).
  2. Search for SEO and click Install and then Enable.

Manual

  1. Download the latest release from the Releases page and navigate to your Obsidian vault's .obsidian/plugins/ directory.
  2. Create a new folder called seo and ensure manifest.json, main.js, and styles.css are in there.
  3. In Obsidian, go to Settings > Community plugins (enable it if you haven't already) and then enable "SEO."

Privacy & Security

Note: This plugin includes an optional external link checking feature that requires an internet connection. This feature is disabled by default and can be enabled in the plugin settings if desired. All other SEO checks work entirely offline.

Contributing

Submit issues or pull requests on the GitHub repository. Contributions to enhance features, improve documentation, or fix bugs are welcome!

Sponsors