onevteam

vslnk

One-V LLM Serve makes every public page on your WordPress site available as clean Markdown at the same URL with a <code>.md</code> extension — zero configuration required.
<pre><code>https://example.com/about/ ← HTML page for humans
https://example.com/about.md ← clean Markdown for AI
</code></pre>
AI systems — ChatGPT, Perplexity, ClaudeBot, Google AI Overviews, and most RAG pipelines — parse Markdown far more efficiently than HTML. When these systems encounter an HTML page, they must strip navigation, headers, footers, sidebars, scripts, and tracking pixels before they can read the actual content. This noise introduces errors, increases token cost, and leads to lower-quality outputs.
The Markdown file contains a configurable YAML frontmatter block followed by the page title, headings in correct hierarchy, and the body text. Nothing else.
<h4>Core features</h4>
<ul>
<li>Zero-config Markdown endpoint for every public post, page, and custom post type</li>
<li>YAML frontmatter with configurable fields (<code>title</code>, <code>date</code>, <code>modified</code>, <code>url</code>, <code>description</code>, <code>image</code>, <code>tags</code>, <code>categories</code>, <code>lang</code>, <code>type</code>)</li>
<li><code>/llms.txt</code> discovery file at the site root following the <a href="https://llmstxt.org" rel="nofollow ugc">llmstxt.org</a> convention</li>
<li>Taxonomy archives as Markdown — <code>/category/news.md</code>, <code>/tag/foo.md</code>, custom taxonomies</li>
<li><code>?format=markdown</code> query parameter as an alternative to the <code>.md</code> URL on any singular page</li>
<li>Per-post exclude via a sidebar checkbox on the post editor</li>
<li>Works with Classic Editor and Gutenberg via the <code>the_content</code> filter</li>
<li>ACF integration — opt-in per-post: pick which text, textarea, WYSIWYG, URL, email, or link fields to append below the body</li>
<li>Filterable AI analytics — per-hit events with full denormalised dimensions (UA bucket, referrer host, language, post type, response code), sticky filter bar that drives every chart and table live, six KPI tiles, a stacked-area time chart, three composition donuts (UA bucket / referrer source / language), four Top tables, a User-Agent classifier transparency table, and a Recent Activity stream. Referrers are tracked by hostname only — paths and query strings are stripped before storage so no PII is retained. Forward-compatible classification: when the bot or referrer catalogue is updated in a future release, historical rows are reclassified automatically — no Reset Analytics required.</li>
<li>Browser-bucket sub-classification — anything that looks like a browser visit gets split into four kinds based on the <code>Sec-Fetch-Site</code>, <code>Sec-Fetch-User</code>, and <code>Sec-CH-UA</code> request headers a real browser sends: verified user (top-level navigation triggered by a click or address-bar Enter in a recognised browser), headed agent (real Chromium driven programmatically — Playwright, Puppeteer, Selenium), script agent (bare HTTP client imitating a browser UA — <code>requests</code>, <code>httpx</code>, LangChain, custom agents), spoofer (UA shape that no real browser would emit, like modern Chrome with a non-reduced UA). Visible as a stacked-bar breakdown on the User-Agents subpage so you can see at a glance how much of your “human” traffic is actually automation, and rendered inline as colour-coded slugs on every browser-bucket row in the Recent Activity table on the Analytics page. Detection is server-side fingerprinting of the request itself — no cookies, no JS, no IP.</li>
</ul>
<h4>Discoverability</h4>
<ul>
<li><code>Link: rel="alternate"; type="text/markdown"</code> HTTP header on every HTML page</li>
<li><code><link rel="alternate"></code> tag in <code><head></code> for HTML-based discovery</li>
<li><code>Allow: /*.md$</code> directive in <code>robots.txt</code></li>
<li>CORS <code>Access-Control-Allow-Origin: *</code> on <code>.md</code> and <code>/llms.txt</code> so browser-based AI clients can fetch them</li>
</ul>
<h4>Operations</h4>
<ul>
<li>Transient caching with automatic invalidation on <code>save_post</code>, on ACF field value saves, on any ACF field group change, and on plugin settings save</li>
<li>“Clear cache” button in the settings page</li>
<li>Admin notice on fallback HTTP fetch failures</li>
<li>“Settings” link next to the plugin row in Plugins screen</li>
<li>“View .md” row action in the Posts and Pages list tables</li>
</ul>
<h4>Developer hooks</h4>
<ul>
<li><code>ovls_markdown</code> filter for the final Markdown output</li>
<li><code>ovls_frontmatter</code> filter for adding, removing, or modifying frontmatter fields</li>
<li><code>ovls_content_queries</code> filter for the HTML extraction XPath cascade</li>
</ul>
<h4>How it works</h4>
Each request to <code>/about.md</code> is captured by a WordPress rewrite rule and routed through the plugin’s content generator. The generator runs the post through <code>apply_filters( 'the_content', ... )</code> — the same pipeline WordPress uses on the front end — so Classic Editor, Gutenberg, and shortcodes all work without separate code paths. The rendered HTML is converted to Markdown via <code>league/html-to-markdown</code>, then cached in a WordPress transient.
The cache is invalidated automatically on <code>save_post</code>, on ACF field/group changes, and whenever plugin settings are saved. A manual Clear cache button is also available on the settings page.
<h4>Access methods</h4>
There are three equivalent ways to request the Markdown version of a page:
<ul>
<li><code>.md</code> extension — <code>https://example.com/about.md</code></li>
<li><code>?format=markdown</code> query — <code>https://example.com/about/?format=markdown</code></li>
<li><code>Link: rel="alternate"</code> header — returned by every HTML page</li>
</ul>
The <code>.md</code> URL is the recommended canonical form.
<h4>ACF integration</h4>
When <a href="https://www.advancedcustomfields.com/" rel="nofollow ugc">Advanced Custom Fields</a> is active, ACF field rendering is opt-in at two levels:
<ol>
<li>Site defaults per post type — at Settings → One-V LLM Serve → ACF Defaults, tick fields that should be appended to every post of a given post type.</li>
<li>Per-post override — the One-V LLM Serve metabox on each post editor lists every supported ACF field applicable to that post. Tick fields to replace the site defaults for that one post.</li>
</ol>
Supported ACF types: <code>text</code>, <code>textarea</code>, <code>wysiwyg</code>, <code>url</code>, <code>email</code>, <code>link</code>. Each selected field is rendered under a <code>## Field Label</code> heading. Empty fields are skipped.
<h3>Disclaimer</h3>
This plugin is provided “as is”, without warranty of any kind, express or implied, in accordance with the GNU General Public License v2 or later. The authors and contributors are not liable for any direct, indirect, incidental, special, or consequential damages — including but not limited to data loss, lost profits, business interruption, search-ranking changes, or third-party claims — arising from the use of, or inability to use, this software, even if advised of the possibility of such damages.
By installing and activating the plugin you acknowledge that:
<ul>
<li>You are responsible for testing the plugin in a staging environment before deploying to production.</li>
<li>You are responsible for the content this plugin exposes as Markdown — <code>.md</code> URLs and <code>/llms.txt</code> serve the same content as their HTML counterparts and are intended to be crawled and consumed by AI systems and third-party LLMs.</li>
<li>The plugin does not transmit data to any external service. All Markdown generation, caching, and file writes happen on your own server.</li>
</ul>
Nothing in this disclaimer is intended to exclude or limit liability for matters that cannot lawfully be excluded under the consumer-protection laws of your jurisdiction. For the full legal terms see the GPLv2 license at <a href="https://www.gnu.org/licenses/gpl-2.0.html" rel="nofollow ugc">https://www.gnu.org/licenses/gpl-2.0.html</a>.

One-V LLM Serve

Serve clean Markdown versions of every public page at the same URL with a .md extension for AI crawlers, LLMs, and GEO optimization.

Umay Ajans

Modern AI agents (ChatGPT, Claude, Perplexity, Gemini, etc.) work much better with Markdown than HTML. Umay AI Markdown inspects the incoming <code>Accept</code> header and, only when <code>text/markdown</code> is requested, intercepts the response and serves a clean, agent-friendly Markdown representation of the page.
Browsers, search engines, and any client that does not explicitly ask for Markdown receive the unchanged HTML response. There is no settings page, no cron job, and no external service call.
Key features
<ul>
<li>Zero configuration — install, activate, done.</li>
<li>Only triggers when <code>Accept: text/markdown</code> is present. Regular visitors and search engines are never affected.</li>
<li>Hybrid content extraction: uses <code>the_content</code> for posts/pages, falls back to a DOM-based extractor for archives, taxonomies, and the homepage.</li>
<li>Powered by the industry-standard <a href="https://github.com/thephpleague/html-to-markdown" rel="nofollow ugc">league/html-to-markdown</a> library.</li>
<li>Transient-cached for 12 hours per URL (sha256-keyed). Auto-invalidated on <code>save_post</code>, term edits, theme switches, and menu updates.</li>
<li>Built-in IP rate limiter (30 requests / minute by default) to mitigate abuse.</li>
<li>Strict input sanitization, header injection protection, libxml entity hardening (XXE-safe), and full WordPress Coding Standards compliance.</li>
<li>PSR-4 autoloaded, namespaced OOP code. No globals.</li>
<li>Sends <code>Vary: Accept</code>, <code>X-Robots-Tag: noindex</code>, and <code>X-Content-Type-Options: nosniff</code> on every Markdown response.</li>
</ul>
What gets sent to AI agents
Each Markdown response includes a YAML front-matter block with the page title, site name, canonical URL, and ISO-8601 generation timestamp, followed by the page body converted to Markdown. Navigation, footer, sidebars, scripts, styles, comment forms, related posts, and other page chrome are stripped before conversion.
Filters
Two filters are available for advanced customization:
<ul>
<li><code>umay_mdn_bypass</code> — Return <code>true</code> to skip Markdown handling for the current request.</li>
<li><code>umay_mdn_cache_ttl</code> — Override the default 12-hour cache lifetime (in seconds, minimum 60).</li>
<li><code>umay_mdn_rate_limit</code> — Override the default 30-requests-per-minute rate limit.</li>
<li><code>umay_mdn_converter_options</code> — Modify the league/html-to-markdown converter options array.</li>
</ul>

Umay AI Markdown

Serves clean Markdown to AI agents (ChatGPT, Claude, Perplexity) on Accept: text/markdown. HTML stays default for browsers. Zero-config.

One-V LLM Serve vs Umay AI Markdown