Umay AI Markdown
| 开发者 | umayajans |
|---|---|
| 更新时间 | 2026年5月7日 17:21 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Accept header and, only when text/markdown 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
- Zero configuration — install, activate, done.
- Only triggers when
Accept: text/markdownis present. Regular visitors and search engines are never affected. - Hybrid content extraction: uses
the_contentfor posts/pages, falls back to a DOM-based extractor for archives, taxonomies, and the homepage. - Powered by the industry-standard league/html-to-markdown library.
- Transient-cached for 12 hours per URL (sha256-keyed). Auto-invalidated on
save_post, term edits, theme switches, and menu updates. - Built-in IP rate limiter (30 requests / minute by default) to mitigate abuse.
- Strict input sanitization, header injection protection, libxml entity hardening (XXE-safe), and full WordPress Coding Standards compliance.
- PSR-4 autoloaded, namespaced OOP code. No globals.
- Sends
Vary: Accept,X-Robots-Tag: noindex, andX-Content-Type-Options: nosniffon every Markdown response.
umay_mdn_bypass— Returntrueto skip Markdown handling for the current request.umay_mdn_cache_ttl— Override the default 12-hour cache lifetime (in seconds, minimum 60).umay_mdn_rate_limit— Override the default 30-requests-per-minute rate limit.umay_mdn_converter_options— Modify the league/html-to-markdown converter options array.
安装:
- Upload the
markdown-negotiatorfolder (or the ZIP) via Plugins > Add New > Upload Plugin. - Activate the plugin.
- There is no settings page. The plugin starts working immediately.
curl -H "Accept: text/markdown" https://your-site.com/
You should get back a Content-Type: text/markdown; charset=utf-8 response with a YAML front-matter and a Markdown body.屏幕截图:
常见问题:
Does it slow down my normal site?
No. The plugin returns immediately on template_redirect priority 1 if the request does not include Accept: text/markdown. The cost is roughly a single if check per request.
Does this plugin contact any external services?
No. The plugin does not call any external service, does not send analytics, does not check for updates against a remote server, and does not load any remote assets. All HTML-to-Markdown conversion happens locally using the bundled league/html-to-markdown library.
How is the cache invalidated?
Per-URL cache keys are deleted on save_post and transition_post_status for the affected post. Term edits, theme switches, and menu updates flush the entire Markdown cache.
Is logged-in personalization supported?
No. Logged-in requests always fall back to HTML to avoid leaking nonces, admin bars, or per-user content into a shared Markdown cache. This is by design.
How do I clear the cache manually?
Deactivate and re-activate the plugin. Deactivation calls Cache::flush_all().
Is the Markdown response indexable by search engines?
No. Every Markdown response includes X-Robots-Tag: noindex to prevent duplicate-content issues. The HTML version remains the canonical, indexable representation.
Does this work with caching plugins like LiteSpeed Cache, WP Rocket, or W3 Total Cache?
The plugin sets Vary: Accept so any well-behaved cache layer will store the Markdown and HTML variants separately. If your cache layer ignores the Vary header, exclude the URLs from the cache when the Accept: text/markdown header is present.
更新日志:
- Aligned text domain with WordPress.org plugin slug: changed from
umay-ai-markdowntomarkdown-negotiatoracross plugin header, gettext calls, and POT file (per WP.org review feedback). - Hardened Markdown response output: replaced raw
echo $markdownwithwp_kses( $markdown, array() )to satisfy Plugin Check's late-escape rule while preserving Markdown syntax. - Removed bundled tr_TR translation files; only the English POT template ships in the WordPress.org distribution. Translations now flow through translate.wordpress.org.
- Renamed plugin: "Markdown Negotiator" → "Umay AI Markdown"; slug and text domain changed to
markdown-negotiator(per WordPress.org review feedback to ensure the name is distinctive). - Removed deprecated
libxml_disable_entity_loader()calls inContentExtractorandConverter. XXE protection unchanged: libxml 2.9+ disables external entities by default, andLIBXML_NONETis still passed toloadHTML(). - Refactored Tier 2 (non-singular) request pipeline: replaced the open
ob_start( $callback )ontemplate_redirectwith atemplate_includefilter that opens and closes its buffer (ob_startpaired withob_get_clean) inside a single function scope, satisfying Plugin Check's buffer-pairing requirement. - Added
try/catcharound the template render so a fatal in a theme/plugin returns a clean 500 instead of a half-buffered response.
- HTML sanitization hardening: strip
<style>,<script>,<noscript>blocks via regex (defense in depth on top of league/html-to-markdown'sremove_nodes). - Lazy-load image normalization: promotes
data-lazy-src/data-src/data-originaland the firstsrcsetURL into the realsrc. Drops empty/placeholder images. - Page-builder anchor cleanup: anchors with
href="#elementor-action:...",javascript:, or bare#are unwrapped to plain text. - Internationalization: text domain is now loaded on
initand a base POT file ships in/languages/.
- Initial release.