Maak je WordPress-content automatisch beschikbaar als schone, machinevriendelijke Markdown

AEO – Markdown Server geeft je WordPress-website een tweede, machinevriendelijke weergave van je bestaande content. Je normale website blijft gewoon beschikbaar als HTML voor bezoekers, terwijl ondersteunde content als nette Markdown kan worden opgevraagd.

Je hoeft daarvoor geen tweede versie van iedere pagina te schrijven, geen losse Markdown-bestanden bij te houden en geen ingewikkelde technische infrastructuur op te zetten. De plugin gebruikt de content die al in WordPress staat, verwijdert ongewenste onderdelen, die jij aanwijst, en zet de overgebleven HTML automatisch om naar Markdown.

Dat maakt AEO – Markdown Server interessant wanneer je je openbare websitecontent eenvoudiger beschikbaar wilt maken voor software, ontwikkeltools, AI-gerichte workflows en andere systemen die liever met eenvoudige tekst en duidelijke structuur werken dan met een volledige HTML-pagina.

De gratis Lite-versie bevat de belangrijkste functionaliteit om individuele WordPress-berichten en -pagina’s als Markdown aan te bieden. Bezoekers of machines kunnen Markdown aanvragen via de HTTP Accept: text/markdown-header en, wanneer jij dit inschakelt, via een parameter zoals ?markdown=1.

Wil je verder gaan en ook openbare custom post types ondersteunen, aparte adressen zoals /over-ons.md aanbieden, response headers aanpassen, YAML front matter toevoegen, herkomstinformatie onderaan je Markdown plaatsen en caching van afzonderlijke .md-URL’s beheren? Dan biedt AEO – Markdown Server Pro de meest complete versie.

Inhoudsopgave

Waarom ik AEO – Markdown Server heb gemaakt

WordPress is uitstekend in het maken en weergeven van websites voor mensen. Een bezoeker opent een pagina en krijgt een complete HTML-weergave met navigatie, opmaak, afbeeldingen, scripts, stijlen, widgets en andere onderdelen die samen de website vormen.

Voor een menselijke bezoeker is dat precies wat je wilt. Voor software die voornamelijk geïnteresseerd is in de daadwerkelijke inhoud van een pagina, kan dezelfde HTML echter veel meer informatie bevatten dan nodig is.

De tekst die je hebt geschreven staat tussen allerlei technische elementen. Een menu is belangrijk voor een bezoeker, maar niet altijd voor een systeem dat alleen de tekst van een specifieke pagina nodig heeft. Hetzelfde geldt voor footers, scripts, navigatieblokken en andere onderdelen die deel uitmaken van de volledige websiteweergave.

Markdown biedt hiervoor een veel eenvoudiger formaat. Koppen blijven koppen, links blijven links, lijsten blijven lijsten en belangrijke tekststructuur blijft behouden, maar veel van de extra HTML rond de content verdwijnt.

Je zou natuurlijk handmatig Markdown-versies van je WordPress-pagina’s kunnen maken. Dat betekent alleen dat je dezelfde informatie op twee plaatsen moet onderhouden. Verander je een WordPress-pagina, dan zou je ook de afzonderlijke Markdown-versie moeten aanpassen. Bij enkele pagina’s is dat misschien nog te doen, maar voor een actieve website wordt het al snel onpraktisch.

Ik wilde daarom een oplossing waarbij WordPress de enige bron van waarheid blijft. Je schrijft en onderhoudt je content zoals je dat altijd hebt gedaan. Wanneer een geschikte client vervolgens om Markdown vraagt, maakt AEO – Markdown Server die Markdown-weergave automatisch vanuit dezelfde WordPress-content.

Daarbij vond ik het belangrijk dat de normale website niet vervangen wordt. De canonieke HTML-pagina blijft bestaan en blijft de gewone pagina voor bezoekers. Markdown wordt als een alternatieve representatie aangeboden wanneer deze expliciet wordt aangevraagd.

Dat is de reden waarom ik AEO – Markdown Server heb gemaakt: één WordPress-publicatie onderhouden, maar diezelfde informatie op een nette manier in meerdere geschikte formaten beschikbaar kunnen stellen.

Wat is Markdown en waarom is het nuttig?

Markdown is een eenvoudig tekstformaat waarmee structuur kan worden aangegeven zonder de uitgebreide opmaakcode van een volledige HTML-pagina.

Een titel kan bijvoorbeeld met een eenvoudig #-teken worden aangeduid, links worden compact geschreven en lijsten blijven als duidelijke lijsten herkenbaar. Daardoor is Markdown zowel voor mensen als voor software relatief eenvoudig te lezen.

Je kunt het verschil zien als het verschil tussen een volledig ingerichte webpagina en een schonere tekstversie van de belangrijkste inhoud. De webpagina bevat alles wat nodig is om de website visueel te presenteren. De Markdown-versie concentreert zich veel sterker op de inhoud en structuur.

AEO – Markdown Server gebruikt de bestaande, gerenderde WordPress-content en zet deze om naar Markdown. De plugin bevat hiervoor een HTML-naar-Markdown-converter en laat je bovendien bepaalde HTML-elementen of ondersteunde CSS-selectors verwijderen voordat de conversie plaatsvindt.

Dit is bijvoorbeeld handig wanneer je weet dat een bepaald navigatieblok, een specifieke container of andere herhalende content niet in de Markdown-uitvoer thuishoort.

Markdown is geen vervanging voor je normale WordPress-pagina en het activeren van deze plugin betekent niet dat menselijke bezoekers voortaan een kale tekstpagina zien. Je bestaande HTML-pagina blijft gewoon beschikbaar. De Markdown-versie is een aanvullende representatie voor clients die daar specifiek om vragen.

De belangrijkste functies

Zowel Lite als Pro is gebouwd rond hetzelfde uitgangspunt: je bestaande WordPress-content automatisch als schone Markdown beschikbaar maken zonder een tweede versie van iedere publicatie te hoeven onderhouden.

Lite bevat de kern die nodig is voor normale WordPress-berichten en -pagina’s. Pro breidt deze basis uit met extra contenttypen en aanzienlijk meer controle over hoe Markdown wordt aangevraagd, beschreven, voorzien van metadata en gecachet.

Serveer normale WordPress-berichten en pagina’s als Markdown

Met AEO – Markdown Server kun je individuele WordPress-berichten en pagina’s als text/markdown beschikbaar maken.

Dat betekent niet dat je bestaande pagina wordt vervangen. Wanneer iemand de pagina normaal in een browser opent, blijft WordPress gewoon de gebruikelijke HTML-versie tonen. Alleen wanneer een client specifiek aangeeft dat Markdown gewenst is, kan de plugin de alternatieve Markdown-weergave leveren.

In de instellingen bepaal je zelf of Berichten, Pagina’s of beide hiervoor beschikbaar mogen zijn.

De selectie geldt bewust voor individuele publicaties. Overzichtspagina’s, archieven, zoekresultaten, taxonomie-overzichten en paginering vallen niet automatisch onder deze contenttype-selectie.

Markdown opvragen via de standaard HTTP Accept-header

Een van de belangrijkste manieren waarop AEO – Markdown Server werkt is via zogenaamde HTTP content negotiation.

Dat klinkt technisch, maar het principe is eenvoudig. Wanneer software een webpagina opvraagt, kan deze aangeven welk soort antwoord zij het liefst ontvangt. Een client die Markdown wil ontvangen kan bijvoorbeeld de volgende informatie meesturen:

Accept: text/markdown

AEO – Markdown Server herkent dit verzoek. Wanneer de betreffende WordPress-publicatie voor Markdown is ingeschakeld, kan de plugin vervolgens Markdown terugsturen in plaats van de gewone HTML-weergave.

Het grote voordeel hiervan is dat de gewone URL van je content hetzelfde kan blijven. De client geeft zelf aan welke representatie gewenst is.

Optionele ?markdown=1-URL voor eenvoudig expliciet gebruik

HTTP-headers zijn handig voor software, maar niet altijd praktisch wanneer je zelf snel een Markdown-versie in een browser wilt controleren of wanneer caching een rol speelt.

Daarom kunnen zowel Lite als Pro een expliciete Markdown GET-parameter ondersteunen. Wanneer deze optie is ingeschakeld, kan een Markdown-versie bijvoorbeeld worden aangevraagd via:

https://jouwdomein.nl/voorbeeldpagina/?markdown=1

Een andere niet-nulwaarde voor de markdown-parameter kan eveneens als Markdown-verzoek worden behandeld.

Dit geeft je een eenvoudig herkenbare manier om expliciet om Markdown te vragen zonder zelf een aangepaste HTTP-header te hoeven instellen.

Pro voegt echte afzonderlijke .md-URL’s toe

Met AEO – Markdown Server Pro kun je nog een derde toegangsmethode gebruiken: een afzonderlijke URL die eindigt op .md.

Een pagina zoals:

https://jouwdomein.nl/over-ons/

kan dan bijvoorbeeld ook beschikbaar zijn via:

https://jouwdomein.nl/over-ons.md

Voor de client blijft het .md-adres zichtbaar. Achter de schermen koppelt WordPress het verzoek intern aan de oorspronkelijke publicatie en genereert AEO – Markdown Server de Markdown-versie.

Dit is een belangrijk voordeel van Pro wanneer je expliciete, afzonderlijke en gemakkelijk herkenbare Markdown-URL’s wilt aanbieden.

Pro ondersteunt openbare custom post types

Lite richt zich op de twee standaardcontenttypen die vrijwel iedere WordPress-website gebruikt: Berichten en Pagina’s.

Veel websites gebruiken echter aanvullende contenttypen. Een webshop kan bijvoorbeeld producten bevatten. Een andere website kan evenementen, vacatures, portfolio-items, recensies, cursussen of andere custom post types gebruiken.

Pro laat je naast Berichten en Pagina’s ook geschikte openbare custom post types selecteren.

Daardoor kan de Markdown-functionaliteit veel beter aansluiten op websites die WordPress gebruiken als uitgebreid contentmanagementsysteem en waar belangrijke informatie niet alleen in gewone berichten en pagina’s staat.

Verwijder ongewenste HTML-elementen voordat de Markdown wordt gemaakt

Een WordPress-pagina kan naast de eigenlijke tekst allerlei aanvullende HTML bevatten. Niet ieder onderdeel daarvan hoeft in een Markdown-weergave terecht te komen.

Daarom kun je in zowel Lite als Pro aangeven welke HTML-elementen vóór de conversie moeten worden verwijderd.

Je kunt bijvoorbeeld elementnamen invoeren zoals:

nav header footer script style aside

Wanneer zulke elementen aanwezig zijn in de te converteren HTML, kan de plugin ze verwijderen voordat de overgebleven informatie naar Markdown wordt omgezet.

Dit helpt om de uiteindelijke uitvoer schoner te maken en onnodige onderdelen buiten de Markdown-representatie te houden.

Verwijder specifieke onderdelen met ondersteunde CSS-selectors

Soms wil je niet ieder element van een bepaald type verwijderen. Misschien wil je slechts één specifieke container, klasse of onderdeel van je pagina buiten de Markdown houden.

AEO – Markdown Server biedt daarom ook ondersteuning voor configureerbare CSS-selectors.

De plugin ondersteunt verschillende gangbare selectorvormen, waaronder elementen, ID’s, klassen, attributen, onderliggende elementen en directe kinderen. Zo kun je gerichter bepalen welke HTML vóór de conversie wordt verwijderd.

Voor een niet-technische gebruiker is de belangrijkste gedachte hierbij eenvoudig: als een bepaald websiteonderdeel steeds in de Markdown terechtkomt terwijl je dat niet wilt, kun je de plugin instrueren om dat onderdeel eerst te verwijderen.

De Markdown-versie verwijst terug naar de canonieke HTML-pagina

De normale WordPress-pagina blijft de oorspronkelijke webpagina. Daarom voegt de plugin essentiële informatie toe waarmee duidelijk kan blijven waar de Markdown-uitvoer vandaan komt.

De Markdown-response kan onder andere een canonieke verwijzing naar de normale HTML-pagina bevatten en geeft aan dat het antwoord het contenttype text/markdown gebruikt.

Hierdoor wordt Markdown niet gepresenteerd alsof het een volledig losstaande publicatie zonder bron is. De relatie met de oorspronkelijke WordPress-pagina blijft behouden.

Markdown discovery helpt geschikte clients de alternatieve versie te vinden

AEO – Markdown Server kan Markdown-alternatieven adverteren zodat geschikte software kan ontdekken dat er naast de gewone HTML-versie ook een Markdown-representatie beschikbaar is.

Dit past bij het bredere uitgangspunt van de plugin: je hoeft menselijke bezoekers niet naar een andere website of aparte publicatie te sturen. De bestaande WordPress-content blijft centraal staan, terwijl machinevriendelijke alternatieven daarnaast beschikbaar worden gemaakt.

Een speciale Markdown-feed is inbegrepen

Zowel Lite als Pro biedt daarnaast een speciale Markdown-feed.

Een feed is een automatisch overzicht van recente publicaties. WordPress gebruikt feeds bijvoorbeeld al lange tijd voor RSS. AEO – Markdown Server voegt een Markdown-georiënteerde feed toe waarmee geschikte clients publicaties in een workflow kunnen ontdekken en de bijbehorende Markdown-informatie kunnen verwerken.

De plugin kan deze feed ook adverteren vanuit normale WordPress-pagina’s en vanuit de standaard RSS-informatie.

Zo krijgt de Markdown-functionaliteit niet alleen waarde op het niveau van één individuele pagina, maar is er ook een manier om publicaties als verzameling te ontdekken.

Pro laat je de X-Markdown-Generator-header aanpassen

HTTP-responses kunnen naast hun inhoud ook aanvullende technische informatie bevatten in zogenaamde headers.

Met Pro kun je optioneel de header X-Markdown-Generator meesturen. Hiermee kan worden aangegeven welke generator verantwoordelijk was voor de Markdown-weergave.

Je kunt de waarde van deze header zelf instellen. Dit is vooral interessant voor ontwikkelaars, integraties of organisaties die duidelijk willen maken hoe een Markdown-representatie is gegenereerd.

In Lite worden de essentiële headers gewoon afgehandeld, maar deze aanvullende generatoraanpassing is exclusief voor Pro.

Pro kan automatisch het aantal woorden in de Markdown-response meesturen

Pro kan bovendien de optionele X-Markdown-Word-Count-header toevoegen.

Hierin staat het aantal woorden van de gegenereerde Markdown-response. Voor een gewone websitebezoeker is dit waarschijnlijk geen belangrijke informatie, maar software die Markdown verwerkt kan dergelijke metadata nuttig vinden.

Je bepaalt zelf of deze aanvullende header wordt gebruikt.

Pro kan YAML front matter toevoegen aan iedere Markdown-weergave

Een van de krachtigste Pro-functies is ondersteuning voor front matter.

Front matter is een blok gestructureerde metadata bovenaan een Markdown-document. De gewone tekst van de pagina komt daaronder te staan.

Een machine hoeft daardoor niet eerst allerlei informatie uit de tekst zelf af te leiden. Belangrijke metadata kan duidelijk en afzonderlijk worden aangeboden.

In Pro zijn de titel en canonieke URL opgenomen wanneer deze beschikbaar zijn. Daarnaast kun je optionele velden inschakelen voor:

  • Beschrijving
  • Auteur
  • Publicatiedatum
  • Afbeelding
  • Markdown-URL

Lege waarden worden niet onnodig afgedrukt. Daardoor blijft de uitvoer zo netjes mogelijk.

Pro kan herkomstinformatie onderaan de Markdown toevoegen

Naast metadata bovenaan kan Pro ook een configureerbare provenance footer onderaan de gegenereerde Markdown plaatsen.

Provenance betekent in deze context simpel gezegd informatie over de herkomst en het beheer van de content.

Je kunt onder andere kiezen voor:

  • Datum en tijd waarop de Markdown is gegenereerd
  • Wie de content beheert
  • De bronwebsite
  • Publieke contactinformatie

Daarnaast beschikt Pro over een afzonderlijk veld Generated for. Hiermee kun je een eigen openingsregel aan de footer toevoegen. Laat je deze leeg, dan wordt deze regel niet weergegeven.

Dit geeft Pro veel meer mogelijkheden om gegenereerde Markdown van duidelijke context en broninformatie te voorzien.

Pro ondersteunt optionele publieke contactinformatie

Wanneer je wilt dat ontvangers van de Markdown eenvoudig kunnen zien hoe zij contact met de website-eigenaar kunnen opnemen, kun je in Pro een contactwaarde instellen.

Dat kan bijvoorbeeld een e-mailadres zijn, een URL naar een contactpagina of een andere openbare contactwaarde.

Wanneer het veld voor de Markdown-footer is ingeschakeld, kan deze informatie vervolgens onderaan de gegenereerde Markdown worden weergegeven.

Pro geeft je controle over caching van afzonderlijke .md-URL’s

Caching kan websites sneller maken doordat een eerder gegenereerd resultaat tijdelijk wordt opgeslagen en opnieuw wordt gebruikt. Bij meerdere representaties van dezelfde URL moet daar echter voorzichtig mee worden omgegaan.

Een gewone HTML-pagina en een Markdown-response mogen immers niet per ongeluk door een page cache door elkaar worden gehaald.

AEO – Markdown Server behandelt Markdown-verzoeken via dezelfde URL en de GET-parameter daarom voorzichtig en signaleert compatibele page caches dat deze responses niet als een gewone HTML-pagina gecachet moeten worden.

De afzonderlijke .md-URL’s van Pro zijn anders. Omdat deze een eigen adres hebben, kan Pro je de mogelijkheid geven om page caching hiervoor expliciet toe te staan.

Deze instelling staat bewust niet zomaar onbeperkt aan. Sommige caching- en optimalisatieoplossingen zijn sterk op HTML gericht en kunnen platte Markdown veranderen of ongewenste HTML injecteren. Daarom is het verstandig deze optie alleen te gebruiken nadat je hebt gecontroleerd dat je cachingstack de Markdown correct behandelt.

Hoe werkt AEO – Markdown Server?

De techniek achter content negotiation en Markdown-conversie kan behoorlijk technisch zijn, maar voor normaal gebruik hoef je die techniek niet zelf te bouwen of te begrijpen. Je configureert de plugin vanuit de vertrouwde WordPress-beheeromgeving.

  1. Installeer de plugin. Ga in WordPress naar Plugins > Nieuwe plugin toevoegen > Plugin uploaden, upload Lite of Pro en activeer de gekozen versie.
  2. Open de instellingen. Ga naar de instellingenpagina van AEO – Markdown Server.
  3. Kies welke content als Markdown beschikbaar mag zijn. In Lite kun je Berichten en Pagina’s selecteren. Pro voegt daar geschikte openbare custom post types aan toe.
  4. Kies de gewenste toegangsmethoden. Een geschikte client kan altijd gebruikmaken van de ondersteunde Markdown-contentonderhandeling. Je kunt daarnaast de ?markdown=1-methode inschakelen. Pro kan bovendien afzonderlijke .md-URL’s activeren.
  5. Bepaal welke onderdelen vóór conversie moeten worden verwijderd. Voeg ongewenste HTML-elementnamen of ondersteunde CSS-selectors toe wanneer bepaalde onderdelen niet in de Markdown thuishoren.
  6. Configureer in Pro de response headers. Kies eventueel voor een generatorheader en een woordentelling.
  7. Configureer in Pro de Markdown-metadata. Selecteer gewenste front matter-velden en bepaal welke herkomstinformatie onderaan wordt weergegeven.
  8. Stel indien gewenst contactinformatie in. Deze kan in Pro in de Markdown-footer worden gebruikt.
  9. Controleer in Pro de cachinginstelling voor .md-URL’s. Schakel caching alleen in wanneer je caching- en optimalisatieomgeving platte Markdown correct verwerkt.
  10. Sla de instellingen op. De plugin kan vanaf dat moment geschikte WordPress-content automatisch als Markdown serveren.

Wanneer vervolgens een Markdown-verzoek binnenkomt, controleert de plugin eerst of het verzoek betrekking heeft op een toegestaan individueel contentitem. Daarna wordt de gerenderde WordPress-HTML opgehaald.

Eventuele HTML-elementen en CSS-geselecteerde onderdelen die jij hebt uitgesloten worden verwijderd. De overgebleven HTML wordt daarna door de meegeleverde HTML-naar-Markdown-bibliotheek omgezet.

In Pro kan vervolgens front matter worden toegevoegd, gevolgd door de eigenlijke Markdown-content en eventueel de configureerbare footer.

Daarna stuurt WordPress de uitvoer terug met het juiste Markdown-contenttype en de relevante response headers.

De normale HTML-pagina wordt daarbij niet verwijderd of vervangen. Wanneer een gewone bezoeker dezelfde publicatie normaal opent, blijft de reguliere WordPress-pagina beschikbaar.

Een eenvoudig praktijkvoorbeeld

Stel dat je een pagina hebt op:

https://jouwdomein.nl/diensten/

Een normale bezoeker opent deze URL en ziet je volledige website met header, navigatie, styling, afbeeldingen, footer en alle andere onderdelen.

Een softwareclient kan dezelfde URL opvragen met:

Accept: text/markdown

AEO – Markdown Server kan vervolgens een schone Markdown-weergave van de toegestane inhoud terugsturen.

Wanneer je de GET-parameter hebt ingeschakeld, kun je dezelfde weergave bijvoorbeeld aanvragen via:

https://jouwdomein.nl/diensten/?markdown=1

Gebruik je Pro en heb je afzonderlijke Markdown-URL’s ingeschakeld, dan kan ook het volgende adres beschikbaar zijn:

https://jouwdomein.nl/diensten.md

Je onderhoudt ondertussen maar één daadwerkelijke WordPress-pagina. De verschillende representaties worden daar automatisch uit opgebouwd.

Lite of Pro: welke versie past bij jou?

AEO – Markdown Server Lite is bedoeld om de essentiële Markdown-serverfunctionaliteit gratis beschikbaar te maken. Voor een website die voornamelijk bestaat uit gewone WordPress-berichten en -pagina’s, biedt Lite al een sterke basis.

AEO – Markdown Server Pro is bedoeld voor websites en beheerders die meer contenttypen willen ondersteunen en precies willen bepalen hoe Markdown wordt aangeboden, beschreven en voorzien van aanvullende metadata.

Functie Lite Pro
Individuele WordPress-berichten als Markdown serveren Ja Ja
Individuele WordPress-pagina’s als Markdown serveren Ja Ja
Openbare custom post types als Markdown serveren Nee Ja
Markdown aanvragen via Accept: text/markdown Ja Ja
Optionele ?markdown=1-methode Ja Ja
Afzonderlijke .md-URL’s zoals /over-ons.md Nee Ja
HTML-elementen verwijderen vóór conversie Ja Ja
Ondersteunde CSS-selectors verwijderen vóór conversie Ja Ja
Automatische HTML-naar-Markdown-conversie Ja Ja
Normale HTML-pagina blijft canonieke bron Ja Ja
Essentiële Markdown response headers Ja Ja
Markdown-alternatieven adverteren Ja Ja
Speciale Markdown-feed Ja Ja
X-Markdown-Generator-header inschakelen en aanpassen Nee Ja
X-Markdown-Word-Count-header Nee Ja
YAML front matter Nee Ja
Titel en canonieke URL in front matter Nee Ja, indien beschikbaar
Optionele beschrijving in front matter Nee Ja
Optionele auteur in front matter Nee Ja
Optionele publicatiedatum in front matter Nee Ja
Optionele afbeelding in front matter Nee Ja
Optionele Markdown-URL in front matter Nee Ja
Configureerbare Markdown-footer Nee Ja
Generated date and time in footer Nee Optioneel
Maintained by in footer Nee Optioneel
Source in footer Nee Optioneel
Contactinformatie in footer Nee Optioneel
Eigen Generated for-regel Nee Ja
Caching van afzonderlijke .md-URL’s toestaan Nee Ja
Automatische Lite/Pro-conflictafhandeling Ja Ja
Zelfstandige plugin, andere editie niet vereist Ja Ja

Waarom kiezen voor Pro?

Lite bevat bewust de belangrijkste functionaliteit om Markdown-serving daadwerkelijk te kunnen gebruiken. Je krijgt dus geen eenvoudige demonstratie waarbij de kern achter een betaalmuur zit. Voor een website met normale WordPress-berichten en -pagina’s kun je Lite daadwerkelijk gebruiken om Markdown-responses beschikbaar te maken.

Pro wordt vooral waardevol wanneer Markdown een serieus onderdeel van de manier wordt waarop je website content aan machines en externe toepassingen aanbiedt.

Het eerste grote verschil is ondersteuning voor openbare custom post types. Gebruik je WooCommerce, een evenementensysteem, een portfolio, een vacatureplugin, een cursusplatform of een andere oplossing die eigen openbare contenttypen toevoegt, dan kun je deze in Pro eveneens beschikbaar maken.

Het tweede grote verschil is de afzonderlijke .md-URL. In plaats van alleen content negotiation of een queryparameter te gebruiken, kun je een duidelijk zelfstandig Markdown-adres aanbieden zoals /pagina.md.

Daarbovenop krijg je controle over technische en beschrijvende metadata. Je kunt generatorinformatie meesturen, het aantal woorden aangeven, front matter samenstellen en onderaan de Markdown duidelijk maken wanneer deze is gegenereerd, wie de content beheert, waar de bron zich bevindt en hoe contact kan worden opgenomen.

Voor websites die Markdown alleen als handige alternatieve representatie van gewone berichten en pagina’s willen aanbieden, is Lite een uitstekende gratis start. Voor professionele websites die verschillende contenttypen hebben en hun machinevriendelijke uitvoer bewust willen structureren en documenteren, biedt AEO – Markdown Server Pro aanzienlijk meer mogelijkheden.

Lite maakt je WordPress-content beschikbaar als Markdown. Pro geeft je controle over hoe die Markdown wordt aangeboden, beschreven, gevonden en beheerd.

Prijs

AEO – Markdown Server Lite

Gratis voor iedereen.

AEO – Markdown Server Lite wordt gratis beschikbaar gesteld en bevat de kernfunctionaliteit van de Markdown-server.

Je kunt WordPress-berichten en -pagina’s selecteren, Markdown aanbieden via de ondersteunde Accept-header, optioneel de ?markdown=1-methode gebruiken, ongewenste HTML verwijderen, Markdown-alternatieven adverteren en gebruikmaken van de speciale Markdown-feed.

Lite is daarmee een functionele gratis editie waarmee je de belangrijkste toepassing van de plugin daadwerkelijk kunt gebruiken.

DOWNLOAD VOOR DE LITE VERSION VOLGT SPOEDIG

AEO – Markdown Server Pro

Daarvoor krijg je ondersteuning voor openbare custom post types, afzonderlijke .md-URL’s, configureerbare response headers, YAML front matter, herkomstinformatie en footers, publieke contactinformatie en geavanceerde cachingcontrole voor afzonderlijke Markdown-URL’s.

De Pro-versie van AEO – Markdown Server is een gespecialiseerde tool. Mensen die begrijpen waarom zij schone Markdown-versies nodig hebben voor AI-systemen, LLM’s of andere geautomatiseerde systemen, zullen waarschijnlijk ook de aanzienlijke waarde ervan inzien. Mijn Pro-editie voegt onder andere ondersteuning voor aangepaste berichttypen, specifieke .md-URL’s, configureerbare headers, YAML front matter, herkomst- en contactinformatie en Markdown-caching toe. Hierdoor verandert de plugin van een ‘eenvoudige’ formaatconverter in een veel krachtiger hulpmiddel voor uitgevers die hun websites bewust beter machineleesbaar willen maken.

Betaal eenmalig €49 per website in plaats van op zoek te gaan naar plugins die hetzelfde of minder bieden tegen terugkerende of hogere kosten.
Tijdelijk is er een speciale introductieprijs van €29 voor een levenslange licentie per website.

Loading…

Levenslange licentie en updates inbegrepen.
Standaard ondersteuning is inbegrepen gedurende 6 maanden.
Aanvullende ondersteuning buiten deze periode wordt per situatie besproken.
De aankoopmogelijkheden en de Lite- en Pro-versies worden in de komende weken beschikbaar gesteld.

Loading…

Veelgestelde vragen

  • Wat doet AEO – Markdown Server precies?
    • AEO – Markdown Server kan geselecteerde individuele WordPress-publicaties naast hun normale HTML-weergave ook als text/markdown beschikbaar maken. De plugin gebruikt de bestaande WordPress-content, verwijdert eventueel door jou uitgesloten onderdelen en zet de resterende HTML automatisch om naar Markdown. De gewone website blijft ondertussen gewoon beschikbaar.
  • Wat is Markdown?
    • Markdown is een relatief eenvoudig tekstformaat waarmee structuur zoals koppen, links, lijsten, citaten en nadruk kan worden weergegeven zonder de hoeveelheid markup die een volledige HTML-webpagina normaal bevat. Hierdoor is de daadwerkelijke inhoud vaak eenvoudiger te lezen en te verwerken door software.
  • Vervangt Markdown mijn normale WordPress-pagina?
    • Nee. De normale HTML-pagina blijft bestaan en blijft de gewone versie die menselijke bezoekers in hun browser zien. AEO – Markdown Server voegt een alternatieve Markdown-representatie toe voor clients die daar expliciet om vragen. Je hoeft dus geen keuze te maken tussen een normale website en Markdown.
  • Moet ik technisch zijn om de plugin te gebruiken?
    • Nee. De belangrijkste configuratie gebeurt vanuit WordPress. Je kiest bijvoorbeeld welke contenttypen als Markdown mogen worden aangeboden en welke onderdelen vóór conversie moeten worden verwijderd. Sommige Pro-functies, zoals aangepaste headers, CSS-selectors en cachinginstellingen, zijn technischer van aard, maar je hoeft deze niet allemaal te gebruiken om de basisfunctionaliteit te benutten.
  • Welke content kan ik met Lite als Markdown aanbieden?
    • Lite ondersteunt individuele WordPress-berichten en -pagina’s. Je kunt Berichten, Pagina’s of beide selecteren. De selectie geldt niet automatisch voor archieven, overzichtspagina’s, zoekresultaten, taxonomiepagina’s of paginering.
  • Welke extra content ondersteunt Pro?
    • Pro kan naast Berichten en Pagina’s ook geschikte openbare custom post types gebruiken. Welke custom post types je ziet, hangt af van de plugins en het thema op jouw website. Denk bijvoorbeeld aan producten, evenementen, portfolio-items, vacatures, cursussen of andere openbare contenttypen die door WordPress-extensies zijn toegevoegd.
  • Wat betekent Accept: text/markdown?
    • Wanneer software een pagina op internet opvraagt, kan deze via een HTTP-header aangeven welk type antwoord gewenst is. Met Accept: text/markdown geeft de client aan dat Markdown gewenst is. Als de betreffende WordPress-publicatie daarvoor is ingeschakeld, kan AEO – Markdown Server vervolgens een Markdown-response terugsturen.
  • Wat doet ?markdown=1?
    • Wanneer deze toegangsmethode is ingeschakeld, kun je expliciet om Markdown vragen door ?markdown=1 aan de normale URL toe te voegen. Bijvoorbeeld https://jouwdomein.nl/pagina/?markdown=1. Dit kan praktisch zijn wanneer je de Markdown zelf wilt controleren of wanneer dezelfde-URL content negotiation minder geschikt is door de cachingconfiguratie van de website.
  • Wat is het voordeel van een .md-URL in Pro?
    • Pro kan een afzonderlijk en duidelijk herkenbaar adres zoals /over-ons.md beschikbaar maken. De client vraagt daarmee direct een URL op die specifiek voor Markdown bedoeld is. WordPress koppelt deze achter de schermen aan de oorspronkelijke publicatie terwijl het .md-adres voor de client zichtbaar blijft. Dit maakt HTML en Markdown ook eenvoudiger van elkaar te onderscheiden in caching- en integratieworkflows.
  • Moet ik zelf aparte Markdown-bestanden maken?
    • Nee. Dat is juist een van de belangrijkste voordelen van de plugin. Je onderhoudt je content gewoon in WordPress. Wanneer Markdown wordt aangevraagd, gebruikt AEO – Markdown Server de gerenderde WordPress-content en zet deze automatisch om. Je hoeft dezelfde pagina dus niet nogmaals handmatig als Markdown te schrijven.
  • Kan ik ongewenste onderdelen uit de Markdown verwijderen?
    • Ja. Zowel Lite als Pro laat je HTML-elementnamen en ondersteunde CSS-selectors instellen die vóór de Markdown-conversie moeten worden verwijderd. Dit is bijvoorbeeld nuttig wanneer navigatie, een footer, een specifiek blok of een andere herhalende component niet thuishoort in de machinevriendelijke weergave.
  • Wat zijn CSS-selectors en heb ik die nodig?
    • Een CSS-selector is een manier om een specifiek HTML-element of een groep elementen op een webpagina aan te wijzen. Bijvoorbeeld een bepaalde klasse of ID. Je hebt deze functie niet nodig voor normaal gebruik, maar hij kan handig zijn wanneer je zeer gericht een bepaald onderdeel uit de Markdown wilt verwijderen zonder alle elementen van hetzelfde type te verwijderen.
  • Wat is de Markdown-feed?
    • De plugin registreert een speciale Markdown-georiënteerde feed waarmee publicaties kunnen worden ontdekt. Je kunt een feed zien als een automatisch overzicht van recente content. De Markdown-feed vormt daarmee een aanvullende manier voor geschikte software om beschikbare publicaties en hun Markdown-weergaven te vinden.
  • Hoe kunnen clients ontdekken dat Markdown beschikbaar is?
    • AEO – Markdown Server kan Markdown-alternatieven en de speciale Markdown-feed adverteren via informatie die vanuit WordPress wordt toegevoegd. Hierdoor hoeft een geschikte client niet uitsluitend vooraf te weten dat een Markdown-weergave bestaat. De normale HTML-content blijft daarbij de centrale webpagina.
  • Wat is front matter?
    • Front matter is gestructureerde metadata die bovenaan een Markdown-document kan worden geplaatst. Je kunt het zien als een klein informatieblok over de publicatie voordat de daadwerkelijke tekst begint. Pro gebruikt een YAML-compatibele vorm en kan zo belangrijke informatie op een duidelijke, machineleesbare manier naast de hoofdinhoud aanbieden.
  • Welke front matter-informatie kan Pro toevoegen?
    • De titel en canonieke URL worden opgenomen wanneer deze beschikbaar zijn. Daarnaast kun je in Pro optioneel een beschrijving, auteur, publicatiedatum, afbeelding en Markdown-URL toevoegen. Velden zonder bruikbare waarde worden niet onnodig weergegeven.
  • Wat is de X-Markdown-Generator-header?
    • Dit is een optionele HTTP-response header die in Pro kan worden ingeschakeld. De header kan aangeven welke generator verantwoordelijk is voor de Markdown-response. Je kunt de waarde zelf configureren. Voor gewone bezoekers is deze informatie niet nodig, maar voor technische integraties kan ze nuttig zijn.
  • Wat doet X-Markdown-Word-Count?
    • Wanneer je deze Pro-optie inschakelt, berekent de plugin het aantal woorden in de gegenereerde Markdown en plaatst dit aantal in de X-Markdown-Word-Count-response header. Externe software kan daardoor het aantal woorden achterhalen zonder dat zelf uit de volledige response te hoeven berekenen.
  • Hoe werkt caching van Markdown?
    • Markdown die via dezelfde URL wordt onderhandeld met een Accept-header of via de queryparameter wordt aangevraagd, moet voorzichtig worden behandeld omdat HTML en Markdown anders door een page cache met elkaar verward kunnen worden. De plugin signaleert daarom dat dergelijke Markdown-responses niet als normale pagina moeten worden gecachet. Pro kan caching voor afzonderlijke .md-URL’s optioneel toestaan, omdat deze een eigen URL hebben. Schakel dit alleen in nadat je hebt gecontroleerd dat je cache- en optimalisatieoplossingen platte Markdown correct bewaren.
  • Blijft mijn normale WordPress-URL de canonieke pagina?
    • Ja. De Markdown-response kan naar de normale WordPress-permalink terugverwijzen als canonieke bron. De plugin is bedoeld om Markdown als aanvullende representatie van dezelfde publicatie aan te bieden, niet om je bestaande webpagina te vervangen.
  • Kunnen Lite en Pro tegelijkertijd actief zijn?
    • Nee, dat is niet nodig. Pro krijgt altijd voorrang. Wanneer Pro wordt geactiveerd terwijl Lite actief is, wordt Lite automatisch gedeactiveerd. Probeert iemand Lite te activeren terwijl Pro actief is, dan schakelt Lite zichzelf weer uit en blijft Pro actief.
  • Heb ik Lite nodig voordat ik Pro kan installeren?
    • Nee. Beide edities zijn zelfstandige plugins. Pro bevat de volledige functionaliteit en heeft Lite niet nodig. Je kunt Pro dus rechtstreeks installeren wanneer je direct alle functies wilt gebruiken.
  • Wat gebeurt er met mijn instellingen wanneer ik de plugin verwijder?
    • Alleen deactiveren bewaart de instellingen van de betreffende editie. Wanneer je Lite daadwerkelijk via WordPress verwijdert, verwijdert het uninstall-proces de opgeslagen Lite-instellingen. Het verwijderen van Pro verwijdert op dezelfde manier de Pro-instellingen. Lite en Pro gebruiken afzonderlijke database-opties, waardoor het verwijderen van de ene editie niet automatisch de instellingen van de andere editie verwijdert.
  • Welke WordPress- en PHP-versie heb ik nodig?
    • De huidige Lite- en Pro-pakketten vereisen minimaal WordPress 6.5 en PHP 8.2. Wanneer je website op een oudere WordPress- of PHP-versie draait, moet deze eerst worden bijgewerkt voordat je de plugin gebruikt.

Maak je bestaande WordPress-content beschikbaar in een eenvoudiger formaat

Je hoeft niet te kiezen tussen een aantrekkelijke website voor mensen en een schonere representatie voor software. AEO – Markdown Server laat je dezelfde WordPress-content voor beide gebruiken.

Je bezoekers blijven je normale website zien. Wanneer een geschikte client Markdown nodig heeft, kan de plugin automatisch een schonere tekstrepresentatie van dezelfde publicatie leveren.

Met Lite krijg je gratis de belangrijkste mogelijkheden voor WordPress-berichten en -pagina’s, inclusief HTTP content negotiation, de optionele Markdown-parameter, content stripping, Markdown discovery en de speciale feed.

Met Pro breid je dat uit naar openbare custom post types en krijg je de functies die belangrijk worden wanneer je volledige controle wilt: afzonderlijke .md-URL’s, configureerbare headers, YAML front matter, provenance footers en cachingbeheer voor Markdown-specifieke URL’s.