{"id":376283,"date":"2026-09-29T14:12:59","date_gmt":"2026-09-29T14:12:59","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/a1-local-md-for-agents\/"},"modified":"2026-09-29T13:26:45","modified_gmt":"2026-09-29T13:26:45","slug":"a1-local-markdown-delivery-inspector","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/a1-local-markdown-delivery-inspector\/","author":18480982,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.1.2","requires":"6.8","requires_php":"8.0","requires_plugins":null,"header_name":"A1 Local Markdown Delivery Inspector","header_author":"A1 Local","header_description":"Publish clean Markdown from public pages, check important details, and test delivery through your cache.","assets_banners_color":"454260","last_updated":"2026-09-29 13:26:45","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/a1local.com.au\/developer-tools\/","header_author_uri":"https:\/\/a1local.com.au\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":59,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"a1local","date":"2026-09-29 13:26:45","revision":3719135}},"upgrade_notice":{"1.0.2":"<p>Names now use the plugin-specific prefix. Saved pre-release settings and exclusions are preserved on first use. Legacy data is retained. Plain-permalink Markdown links now use a1local_mdi_format=markdown; dedicated links are unchanged.<\/p>","1.0.1":"<p>Pre-release name and URL update. On a local test installation, deactivate the old plugin before activating this package, then use the newly advertised Markdown links. Deleting the old test plugin through WordPress also removes shared settings and page choices.<\/p>","1.0.0":"<p>Initial release. Test representative pages, caching and access rules on staging before using on a live site.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3719166,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3719166,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3719166,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3719166,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3719166,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3719135,"resolution":"1","location":"assets","locale":"","width":1265,"height":712},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3719135,"resolution":"2","location":"assets","locale":"","width":1265,"height":712},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3719135,"resolution":"3","location":"assets","locale":"","width":1265,"height":712}},"screenshots":{"1":"Inspect a public page, check important business details, and review the delivery results. The sample business is fictional.","2":"Read and copy the actual Markdown returned by your website, including page metadata and structured data.","3":"Choose eligible content types, optional header delivery and your content usage preference."}},"plugin_section":[],"plugin_tags":[2353,529,4932,4608],"plugin_category":[],"plugin_contributors":[195568],"plugin_business_model":[],"class_list":["post-376283","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-content","plugin_tags-developer-tools","plugin_tags-markdown","plugin_contributors-a1local","plugin_committers-a1local"],"banners":{"banner":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/banner-772x250.png?rev=3719166","banner_2x":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/banner-1544x500.png?rev=3719166","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/icon.svg?rev=3719166","icon":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/icon.svg?rev=3719166","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/screenshot-1.jpg?rev=3719135","caption":"Inspect a public page, check important business details, and review the delivery results. The sample business is fictional."},{"src":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/screenshot-2.jpg?rev=3719135","caption":"Read and copy the actual Markdown returned by your website, including page metadata and structured data."},{"src":"https:\/\/ps.w.org\/a1-local-markdown-delivery-inspector\/assets\/screenshot-3.jpg?rev=3719135","caption":"Choose eligible content types, optional header delivery and your content usage preference."}],"raw_content":"<!--section=description-->\n<p><strong>See what your website shares.<\/strong><\/p>\n\n<p>Markdown Delivery Inspector gives your public WordPress pages a Markdown version and a practical way to check it. Choose a page, inspect the document delivered by your website, and confirm that details such as your services, locations and phone number are still there.<\/p>\n\n<p>The plugin works on your own WordPress site. It needs no AI API key, Cloudflare account or external conversion service.<\/p>\n\n<h4>Publish readable content<\/h4>\n\n<ul>\n<li>Dedicated Markdown links for eligible posts, pages and enabled public custom post types.<\/li>\n<li>Automatic discovery links in the normal page and its HTTP headers.<\/li>\n<li>Optional delivery at the original URL when a client explicitly prefers <code>text\/markdown<\/code> in its Accept header.<\/li>\n<li>Conversion of the anonymous, server-rendered page, including content rendered by the theme, blocks and shortcodes.<\/li>\n<li>Page title, canonical URL, updated date, language, absolute links and valid JSON-LD.<\/li>\n<li>Removal of common navigation, scripts, hidden elements and sections explicitly marked for exclusion.<\/li>\n<\/ul>\n\n<h4>Check what actually arrives<\/h4>\n\n<p>The inspector makes public requests without your WordPress login cookies. It displays the returned Markdown so you can review the output, rather than relying on a conversion setting alone.<\/p>\n\n<ul>\n<li>Check that the dedicated URL returns Markdown.<\/li>\n<li>Check that ordinary page requests return HTML before and after a Markdown request.<\/li>\n<li>Test optional Accept-header delivery at the normal URL.<\/li>\n<li>Check the no-store instruction on each tested Markdown response.<\/li>\n<li>Look for important phrases you supply, ignoring case and punctuation.<\/li>\n<li>Compare response sizes using measured bytes, not estimated tokens.<\/li>\n<li>Copy the delivered Markdown for your own review or workflow.<\/li>\n<\/ul>\n\n<p>A check applies to the selected page and the observed browser request path. It does not prove that every cache location or AI crawler behaves identically. Missing phrases are reported separately from delivery results; the plugin does not invent a search or AI visibility score.<\/p>\n\n<h4>Choose what to share<\/h4>\n\n<p>Select the public content types you want to make available and exclude individual pages in the inspector. Drafts, private posts, password-protected pages, site search-visibility restrictions and supported noindex settings are excluded. Administrator and password-unlock cookies do not unlock Markdown exports.<\/p>\n\n<p>Documents are generated on request. The plugin creates no public export files or document cache, and sends <code>Cache-Control: private, no-store<\/code> with Markdown responses. Check your hosting cache and access integrations before enabling this on a live site.<\/p>\n\n<h4>Built by A1 Local<\/h4>\n\n<p><a href=\"https:\/\/a1local.com.au\/\">A1 Local<\/a> makes practical tools for local businesses and the people who look after their websites.<\/p>\n\n<p>Find our <a href=\"https:\/\/a1local.com.au\/developer-tools\/\">developer tools<\/a> or use <a href=\"https:\/\/a1local.com.au\/contact\/\">product support<\/a> if you need help. The plugin adds no promotional links to your public pages or Markdown output.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>Uses league\/html-to-markdown 5.1.2 under the MIT licence. Its namespace is isolated to avoid collisions with other plugins. The original licence and source provenance are included under <code>vendor\/league-html-to-markdown\/<\/code>. All distributed PHP, JavaScript and CSS source is included in readable form.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin ZIP through Plugins -&gt; Add Plugin -&gt; Upload Plugin, then activate it.<\/li>\n<li>Open Settings -&gt; Markdown Delivery Inspector.<\/li>\n<li>Choose a published page. Optionally enter important phrases, one per line, and save them.<\/li>\n<li>Click Check page. Review delivery, missing details and the Markdown preview.<\/li>\n<li>Check representative pages on your staging site, including the hosting cache and any access restrictions.<\/li>\n<li>If you want Markdown at the normal page URL, enable the optional delivery setting and run the checks again.<\/li>\n<\/ol>\n\n<p>Requires WordPress 6.8 or later, PHP 8.0 or later, and the PHP DOM\/XML extension. Standard dedicated links are available after activation; header delivery is off by default.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"why%20publish%20markdown%20for%20ai%20clients%3F\"><h3>Why publish Markdown for AI clients?<\/h3><\/dt>\n<dd><p>Markdown represents headings, paragraphs, lists and links as readable text. An agent or other client can request that representation instead of processing a complete HTML page. This plugin makes the representation available; each client decides whether to use it.<\/p><\/dd>\n<dt id=\"do%20i%20need%20cloudflare%20or%20an%20ai%20subscription%3F\"><h3>Do I need Cloudflare or an AI subscription?<\/h3><\/dt>\n<dd><p>No. Conversion runs inside WordPress. No external AI service, account or API key is required. This is an independent plugin from A1 Local and is not affiliated with Cloudflare.<\/p><\/dd>\n<dt id=\"where%20is%20a%20page%27s%20markdown%20link%3F\"><h3>Where is a page's Markdown link?<\/h3><\/dt>\n<dd><p>With pretty permalinks, the dedicated route is <code>\/a1-local-markdown-delivery-inspector\/POST_ID.md<\/code>. With plain permalinks, the canonical URL uses the <code>a1local_mdi_format=markdown<\/code> query parameter. The inspector includes an Open Markdown link. Eligible pages also advertise the alternate URL in an HTML link and HTTP Link header.<\/p><\/dd>\n<dt id=\"will%20normal%20visitors%20still%20see%20my%20website%3F\"><h3>Will normal visitors still see my website?<\/h3><\/dt>\n<dd><p>Yes. Dedicated URLs serve Markdown. Header delivery is optional and requires an explicit Accept preference for <code>text\/markdown<\/code> over HTML. Wildcards and equal preferences keep HTML. If you enable header delivery, test the real cache in front of WordPress; some hosts need a bypass rule for Markdown requests.<\/p><\/dd>\n<dt id=\"can%20i%20check%20services%2C%20locations%20or%20contact%20details%3F\"><h3>Can I check services, locations or contact details?<\/h3><\/dt>\n<dd><p>Yes. Enter phrases that should already appear on the page, one per line. The inspector checks whether each phrase occurs in the delivered document, ignoring case and punctuation. These phrases are checks, not extra public content: saving a phrase does not insert it into the Markdown.<\/p><\/dd>\n<dt id=\"does%20it%20improve%20seo%20or%20guarantee%20ai%20citations%3F\"><h3>Does it improve SEO or guarantee AI citations?<\/h3><\/dt>\n<dd><p>No ranking, indexing, citation, training-exclusion or crawler-adoption guarantees are made. Markdown Delivery Inspector publishes a content representation and helps you inspect its delivery. It does not submit pages to AI providers or search engines.<\/p><\/dd>\n<dt id=\"how%20are%20edits%20kept%20current%3F\"><h3>How are edits kept current?<\/h3><\/dt>\n<dd><p>The document is rendered on request. Markdown responses ask caches not to store them. A host configured to ignore these headers can still cache incorrectly, and a previously downloaded document cannot be recalled. The inspector reports observed behaviour on its request path.<\/p><\/dd>\n<dt id=\"does%20it%20support%20my%20page%20builder%2C%20store%20or%20membership%20plugin%3F\"><h3>Does it support my page builder, store or membership plugin?<\/h3><\/dt>\n<dd><p>It reads the full server-rendered theme output. Content created only by browser JavaScript is unavailable. Test your theme, page builder, multilingual setup, WooCommerce store and membership rules on staging. No universal compatibility is claimed. Private areas, accounts, carts and checkout pages are not suitable content to publish through this tool.<\/p><\/dd>\n<dt id=\"how%20can%20developers%20exclude%20restricted%20content%3F\"><h3>How can developers exclude restricted content?<\/h3><\/dt>\n<dd><p>Return <code>false<\/code> from the <code>a1local_mdi_can_export_post<\/code> filter for a restricted post. The filter can restrict access further but cannot override the built-in exclusions. Add a <code>data-a1local-mdi-exclude<\/code> attribute to a rendered element to remove that element and its descendants, including nested structured data.<\/p><\/dd>\n<dt id=\"does%20the%20content%20usage%20setting%20stop%20ai%20training%3F\"><h3>Does the content usage setting stop AI training?<\/h3><\/dt>\n<dd><p>It declares a preference using the Content-Signal header; it does not enforce access restrictions. The default is <code>ai-train=no, search=yes, ai-input=yes<\/code>. An existing Content-Signal response header takes precedence. Whether a client respects the signal is outside the plugin's control.<\/p><\/dd>\n<dt id=\"what%20information%20does%20the%20plugin%20store%20or%20send%3F\"><h3>What information does the plugin store or send?<\/h3><\/dt>\n<dd><p>Settings and per-page exclusions\/important phrases remain in your WordPress database. Check results stay in the current browser screen. The plugin does not send content to an external conversion service or add telemetry, IP logging or a visitor analytics database. Your hosting provider, other plugins and WordPress may have their own logs. Uninstalling removes this plugin's settings and page metadata.<\/p><\/dd>\n<dt id=\"what%20are%20the%20current%20limits%3F\"><h3>What are the current limits?<\/h3><\/dt>\n<dd><p>The plugin handles singular public posts, pages and enabled custom post types, with a 2 MB limit on rendered HTML. It selects the first main landmark, then an article\/content\/body fallback. Inspect unusual themes and pages with several main containers. Archives, browser-only rendering, llms.txt generation, bulk exports and analytics are not included.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Use unique A1 Local Markdown Delivery Inspector prefixes throughout the plugin.<\/li>\n<li>Preserve saved preferences and page exclusions from pre-release versions.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Rename the plugin to A1 Local Markdown Delivery Inspector before its first directory release.<\/li>\n<li>Update the plugin slug, dedicated Markdown URLs and admin page to match the new name.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release with anonymous rendered-page conversion, exclusions, metadata and structured data.<\/li>\n<li>Dedicated Markdown URLs, discovery links and optional HTTP content negotiation.<\/li>\n<li>Public delivery checks, important-phrase checks, measured response sizes and a Markdown preview.<\/li>\n<li>Default no-training signal, no-store responses and no external conversion service.<\/li>\n<\/ul>","raw_excerpt":"Publish clean Markdown for AI agents, preview the delivered content, and check that important business details are present.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/376283","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=376283"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/a1local"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=376283"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=376283"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=376283"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=376283"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=376283"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=376283"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}