--- title: "Should a real estate website serve Markdown alongside HTML" description: "Compare public HTML and Markdown, check content negotiation and cache behavior, and require matching facts before buying an AI retrieval change." canonical: "https://scalewithsearch.com/articles/markdown-html-agent-pages-ai-retrieval" --- ## Site navigation - [Scale With Search](https://scalewithsearch.com/) - Services - Services - [AI systems](https://scalewithsearch.com/ai-systems) - [Site build](https://scalewithsearch.com/work#site-build) - [Whole website fix](https://scalewithsearch.com/work#whole-website-fix) - [Content library with SEO](https://scalewithsearch.com/work#content-library) - [Working session](https://scalewithsearch.com/audit) - Start here - [Send your brief](https://scalewithsearch.com/work#send-your-brief) - [Example scope](https://scalewithsearch.com/work#review-the-example-scope) - [Prices and terms](https://scalewithsearch.com/work#prices-and-terms) - Industries - Real estate - [Real estate agents and teams](https://scalewithsearch.com/for/real-estate) - [Platforms, ownership, and IDX](https://scalewithsearch.com/for/real-estate/real-estate-website-platforms-ownership-idx) - [Search, content, and AI](https://scalewithsearch.com/for/real-estate/real-estate-search-content-ai) - [Inquiries, campaigns, and handoffs](https://scalewithsearch.com/for/real-estate/real-estate-website-inquiries-campaigns-handoffs) - [Buyer, seller, and local pages](https://scalewithsearch.com/for/real-estate/real-estate-buyer-seller-local-resources) - [Rules, privacy, and trust](https://scalewithsearch.com/for/real-estate/real-estate-website-rules-privacy-trust) - Browse by business - [Trades and home services](https://scalewithsearch.com/for/#group-trades) - [Health, wellness, and animal care](https://scalewithsearch.com/for/#group-practices) - [Law, finance, and IT](https://scalewithsearch.com/for/#group-professional) - [Marketing and SEO agencies](https://scalewithsearch.com/for/#group-agencies) - [Shops and manufacturers](https://scalewithsearch.com/for/#group-manufacturing) - [Restaurants, shops, studios, and nonprofits](https://scalewithsearch.com/for/#group-local-services) - Chiropractic practices - [Chiropractic and wellness practices](https://scalewithsearch.com/for/chiropractic-and-wellness-practices) - [Chiropractic and physical therapy clinics](https://scalewithsearch.com/for/chiropractic-and-physical-therapy-clinics) - [All industries](https://scalewithsearch.com/for/) - Resources - Free tools - [AI readiness check](https://scalewithsearch.com/check) - [Free tools](https://scalewithsearch.com/tools/) - [Free Starter Kit](https://scalewithsearch.com/kit/business-memory-starter-kit.zip) - Guides - [AI-native library](https://scalewithsearch.com/ai-native) - [Industry intelligence](https://scalewithsearch.com/intelligence) - [Office job guides](https://scalewithsearch.com/guides/) - [Business memory](https://scalewithsearch.com/articles/business-memory-for-ai-agents-guide) - [Agent governance](https://scalewithsearch.com/articles/ai-agent-governance-guide-small-business) - [Migration and ownership](https://scalewithsearch.com/articles/leaving-vendor-ai-memory-guide) - Articles - [All articles](https://scalewithsearch.com/articles/) - [What changed](https://scalewithsearch.com/changes/) - About - Evidence - [Proof](https://scalewithsearch.com/proof) - Scale With Search - [About](https://scalewithsearch.com/about) - [How it works](https://scalewithsearch.com/how-it-works) # Decide whether your real estate website needs Markdown Serve Markdown only when a defined retrieval need justifies the additional checks. Keep public facts, source dates, contact destinations, and content controls consistent with the HTML page. Google says its AI Search features do not require special AI text files. [Google's AI guidance](https://developers.google.com/search/docs/appearance/ai-features), checked 2026.10.22. For a real estate agent, the buying question is whether the proposed format solves a documented extraction problem. A different response format does not demonstrate more citations or inquiries. ## What is the difference between HTML and Markdown delivery? They can be different representations of the same resource. HTTP content negotiation lets a client express its preferred representation. [MDN's content negotiation guide](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Content_negotiation), checked 2026.10.22. Ask whether the proposal uses the same URL with request headers or a separately published file. Those designs need different acceptance checks. ## Does Google require a Markdown copy for AI Search? No. Google documents no additional AI text-file requirement for its AI Search features. [Google's requirements](https://developers.google.com/search/docs/appearance/ai-features), checked 2026.10.22. A real estate agent can ask a contractor to identify a concrete extraction defect before authorizing this work. Keep Google's requirements separate from another vendor's optional publishing feature. ## What does Cloudflare's conversion feature do? On an enabled zone, it can convert origin HTML when a request accepts Markdown. [Cloudflare's conversion documentation](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/), checked 2026.10.22. Ask the website manager to confirm feature availability for the actual account. Keep the feature's vendor name in a technical brief without implying that every website already uses it. ## How can a developer request each representation? Request the exact page with `Accept: text/html`, then request it with `Accept: text/markdown`. Cloudflare documents the Markdown header in its [usage example](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/), checked 2026.10.22. Save the response headers and body for each request. Do not infer the returned format solely from the requested header. ## What should the comparison record contain? Keep the requested URL, request headers, final URL, response headers, and body together. Add the test time and template name. This proposed evidence record distinguishes a format conversion from a redirect to another resource. Keep the saved responses available for review instead of supplying only a screenshot of rendered text. ## Which facts should match across the formats? Compare the business identity, approved service explanation, report period, source links, and contact destinations. This is a recommended content check. If the page includes property material, inspect its current status and attribution separately. Stop the proposed release when a simplified response drops a qualification that changes the meaning of the public page. ## Must navigation and page decoration remain identical? Evaluate meaning and usability rather than decorative parity. A proposed Markdown view can omit repeated navigation while retaining the article's useful content. Record the intended omissions in the brief. Keep essential caveats and source labels outside that omission list. A missing contact destination is a different defect from an omitted decorative banner. ## Can conversion recover text absent from the source HTML? Do not assume it can. Cloudflare describes conversion of the HTML it obtains from the origin. [Cloudflare's conversion process](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/), checked 2026.10.22. Inspect the actual response body before choosing this remedy. Use the [crawler rendering comparison](/articles/ai-crawlers-javascript-idx-agent-websites) when important text appears only after JavaScript runs. ## What should happen to service and contact links? Require their intended destinations to survive the conversion. Open the extracted link destinations separately and compare them with the approved HTML links. This proposed test covers seller questions, buyer questions, and general contact routes. A readable summary with a broken destination has failed a useful acceptance check even when its headings look correct. ## How should tables be evaluated? Read the converted table as plain text and check its relationships. Keep units, reporting periods, column labels, and caveats attached to their values. This proposed editorial test matters for market reports. If conversion makes the meaning unclear, request an equivalent prose explanation from the same approved source rather than silently dropping the table. ## What should a developer check about caching? Check whether the cache distinguishes the request headers used to select a representation. MDN explains the role of `Vary` in content negotiation. [Negotiation and caches](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Content_negotiation), checked 2026.10.22. Ask for repeated requests in alternating formats. A browser receiving a cached Markdown body needs investigation before the change is released. ## Is the presence of a Vary header sufficient proof? Require observed responses as well as configuration evidence. The header explains the intended variation, while the proposed alternating-request check tests the actual delivery path. Save the returned content type and a distinguishing passage each time. Include any separate edge cache or application cache in the review so the result covers the public route. ## What if Markdown uses a separate URL? Record the relationship between the URLs and the preferred public page. Google's [canonicalization documentation](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls), checked 2026.10.22, explains canonical signals. Ask for a deliberate plan for equivalent content. Keep genuinely different material outside a duplicate-content mapping. Inspect the actual headers instead of assuming a file extension establishes the relationship. ## Does a declared canonical guarantee Google's choice? No. Google describes canonical signals rather than absolute control over its selection. [Google's canonical guidance](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls), checked 2026.10.22. In the proposed acceptance record, distinguish the declared preference from any observed indexing result. A developer can show the declaration without promising which URL every service will cite. ## Should separate Markdown be used to change the public claims? Keep the approved claims aligned. Compare limitations, evidence dates, service boundaries, attribution, and indexing controls. Restrict the conversion to approved public material. Exclude private records and session-only content. If the format needs a shorter explanation, review it as edited public copy. Keep factual changes outside an automatic conversion task. ## What happens to structured data during conversion? Inspect the implementation rather than assuming a universal behavior. Cloudflare documents preserving JSON-LD in its converted output. [Cloudflare's output description](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/), checked 2026.10.22. A custom exporter may behave differently. Record whether the tested response contains the expected data and whether its facts still match the article. ## Can a Markdown test establish actual AI retrieval? It establishes what your test request received. To report actual retrieval, retain evidence from the named service or an attributable request. Keep simulated requests labeled as tests. This recommended evidence distinction prevents a successful local fetch from becoming an unsupported claim that an AI service read, cited, or recommended the page. ## Is this the same job as publishing llms.txt? Treat the jobs separately. This comparison concerns a page's representations, while the [existing llms.txt guide](/articles/llms-txt-real-estate-agent-websites) covers that publishing decision. Define which problem the contractor is solving before bundling both. A real estate agent should receive acceptance evidence for each requested change rather than a generic AI-readiness label. ## What should happen when conversion omits important text? Record the missing passage, its source element, and the affected template. Keep the original HTML response with the defective Markdown response. Request a supported repair or defer the conversion. This proposed failure record gives the next developer a reproducible problem. Do not approve the change while the missing qualification remains unexplained. ## What should the real estate agent receive after the work? Receive the before-and-after comparison, affected URLs, cache checks, contact-link checks, and a rollback instruction. State which format is maintained automatically and which requires editing. These are proposed handoff requirements. Assign the person who will repeat the checks after a template change, especially when report tables or contact blocks are affected. ## Which results must remain unresolved? Leave ranking changes, citation gains, and inquiry increases UNRESOLVED until measured. The format comparison can pass without proving those outcomes. Record the intended measurement separately from implementation acceptance. If a contractor quotes a performance improvement, ask for the tested pages, service, conditions, and source rather than transferring a vendor example to your website. ## When is a Markdown implementation worth accepting? Accept it when a defined retrieval task improves while the approved content and public delivery checks pass. Defer it when the proposal lacks a reproducible problem. Preserve the HTML experience and the comparison record. The real estate agent should be able to inspect what changed and repeat the same checks after the next edit. Bring the response comparisons and unresolved delivery questions to your [real estate website brief](/for/real-estate). Request a written scope through [Scale With Search’s work request](/work). - [Diagnose Cloudflare AI crawler access for a real estate website](/articles/cloudflare-ai-crawler-access-agent-websites) - [Make your housing dataset discoverable from your real estate website](/articles/housing-dataset-schema-discovery-agent-reports) - [Can AI search read the public PDFs on a real estate website](/articles/public-real-estate-pdfs-in-ai-search) ## Related: Real estate - [Diagnose Cloudflare AI crawler access for a real estate website](/articles/cloudflare-ai-crawler-access-agent-websites) - [Make your housing dataset discoverable from your real estate website](/articles/housing-dataset-schema-discovery-agent-reports) - [Can AI search read the public PDFs on a real estate website](/articles/public-real-estate-pdfs-in-ai-search) ---- ```text .|########||. .|########||. .|########||. |##||. .||##|. |##||. .||##|. |##||. .||##|. |#|. .|#|. |#|. .|#|. |#|. .|#|. |#| |#| |#| |#| |#| |#| .#| |#. .#| |#. .#| |#. .#. .#| .#. .#| .#. .#| |#. .#| |#. .#| |#. .#| |# ...... #| |# ...... #| |# ...... #| .# ||#########| #| .# ||#########| #| .# ||#########| #| .#. |######||######|. .#. .#. |######||######|. .#. .#. |######||######|. .#. #. .##|###|##|#|######| .# #. .##|###|##|#|######| .# #. .##|###|##|#|######| .# || |##|#||||||||||||#||#| || || |##|#||||||||||||#||#| || || |##|#||||||||||||#||#| || # |#||||||||||||||||||||#| #. # |#||||||||||||||||||||#| #. # |#||||||||||||||||||||#| #. || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || # .#||||||||||||||||||||||||#| # # .#||||||||||||||||||||||||#| # # .#||||||||||||||||||||||||#| # || ....|||#||||||##|#|||#|#||##||||....|. || || ....|||#||||||##|#|||#|#||##||||....|. || || ....|||#||||||##|#|||#|#||##||||....|. || #. . ....|# ....#||| ||| .#||| ....#. .# #. . ....|# ....#||| ||| .#||| ....#. .# #. . ....|# ....#||| ||| .#||| ....#. .# # . ||||#| .#####|| . .#| .#||| ||||# #. # . ||||#| .#####|| . .#| .#||| ||||# #. # . ||||#| .#####|| . .#| .#||| ||||# #. .| ||||| #. |#|||||. || #. |#||. .||||| || .| ||||| #. |#|||||. || #. |#||. .||||| || .| ||||| #. |#|||||. || #. |#||. .||||| || || |.... #. ....|#. |. ...|. ....|| || || |.... #. ....|#. |. ...|. ....|| || || |.... #. ....|#. |. ...|. ....|| || #. .||||||##||||||##||####|||||||#||||||#| .# #. .||||||##||||||##||####|||||||#||||||#| .# #. .||||||##||||||##||####|||||||#||||||#| .# # .||####|###########################|. # # .||####|###########################|. # # .||####|###########################|. # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#||||||############|######|||||#| # # .#||||||############|######|||||#| # # .#||||||############|######|||||#| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# || | ...|| ...##| | #| .|. |. ##### .. .| || || | ...|| ...##| | #| .|. |. ##### .. .| || || | ...|| ...##| | #| .|. |. ##### .. .| || || ||||| || ||||#| . |. |. |#. ||||| |#| || || || ||||| || ||||#| . |. |. |#. ||||| |#| || || || ||||| || ||||#| . |. |. |#. ||||| |#| || || .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. #.|||||||#############################| ||| .# #.|||||||#############################| ||| .# #.|||||||#############################| ||| .# || ##||#||#||||||#||#||#||#||##. || || ##||#||#||||||#||#||#||#||##. || || ##||#||#||||||#||#||#||#||##. || # .#|||||||||#||#|||||||||||#| # # .#|||||||||#||#|||||||||||#| # # .#|||||||||#||#|||||||||||#| # || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || .# |#||||||||||||||||||||#| #. .# |#||||||||||||||||||||#| #. .# |#||||||||||||||||||||#| #. || |#||||||||||||||||||#| || || |#||||||||||||||||||#| || || |#||||||||||||||||||#| || #. .######|#|#########| .# #. .######|#|#########| .# #. .######|#|#########| .# .#. |#####||||#####| .#. .#. |#####||||#####| .#. .#. |#####||||#####| .#. |# ||########|| #. |# ||########|| #. |# ||########|| #. |# ...... #| |# ...... #| |# ...... #| |#. .#| |#. .#| |#. .#| |#. .#. |#. .#. |#. .#. .#| |#. .#| |#. .#| |#. |#| |#| |#| |#| |#| |#| .|#|. .|#|. .|#|. .|#|. .|#|. .|#|. |##||. .||##| |##||. .||##| |##||. .||##| .||########||. .||########||. .||########||. Scale With Search 2026 [scalewithsearch.com](https://scalewithsearch.com) ```