Od vydání veze pro vývojáře může DokuWiki nativně parsovat GitHub Flavored Markdown (GFM), a to společně s tradiční syntaxí DokuWiki nebo místo ní.
Podpora Markdownu je nová a měla by být považována za částečně experimentální (viz chybějící části níže).
Nová konfigurační volba $conf['syntax'] určuje, který parser je aktivní:
| Hodnota | Chování |
|---|---|
dw | Pouze syntaxe DokuWiki (výchozí, nezměněné chování) |
md | Pouze Markdown (GFM) |
dw+md | Obě syntaxe povoleny, při konfliktu má přednost DokuWiki |
md+dw | Obě syntaxe povoleny, při konfliktu má přednost Markdown |
„Přednost“ určuje, který dialekt vyhraje v případě, že oba interpretují stejné znaky odlišně. Například __text__ je v DokuWiki podtržení, ale v Markdownu silné zvýraznění (bold).
Nativní parser pokrývá nejběžnější konstrukce GFM:
# Nadpis 1. úrovně až ###### Nadpis 6. úrovně)``` a ~~~), včetně info řetězců pro jazyk a název souboru>), včetně obsahu uvnitř (seznamy, kód, tabulky)5. položka → <ol start="5">)| a zarovnáním sloupců~~text~~)*em*, **strong**, ***oboje*** a varianty s podtržítkem)`code` a ``code``)[](target)
Parametry médií DokuWiki fungují i v Markdownovém zápisu obrázků, např. , a klíčová slova ?left/?right/?center jsou dostupná pro zarovnání.
Některé prvky Markdownu/GFM jsou záměrně vynechány, většinou kvůli tomu, že DokuWiki používá jednoprůchodový parser:
= nebo -)- [ ]) -> vhodnější jako plugin:smile:) -> mohou být doplněny pozdějiÚplný seznam vynechaných specifikací s vysvětlením je k dispozici v testovací sadě.
Všechny existující syntaxové pluginy nadále fungují. DokuWiki stále používá stejné interní instrukce parseru a renderer API, takže výstup pluginů není ovlivněn nastavením syntax.
Jiné pluginy, které samy parsují syntaxi nebo generují syntaxi (např. vlastní editory), nemusí fungovat správně, pokud je syntax nastavena na jinou hodnotu než dw.
Aktuální implementace se zaměřila pouze na parsování a renderování Markdownu. Budoucí vydání by měla zlepšit integraci: