New xwiki request

  • description : I’d like to use this for my notes and plans on liquid organization
  • owner name : searoso
  • wiki name : neaty

You can access your new wiki on

Enjoy !

Thanks a lot! Was waiting it so much! =) Happy New year!!

Btw, Markdown extension doesn’t work. ((

What error do you get?

Actually it requires Programming Rights and needs to be installed at the farm level, see

We could install it (I thought it was there already, will check).

It is already installed!


What’s not working?

Indeed, it’s installed, … but when try to switch and use I got an error.

Thanks. I’ll check this out.

@searoso FTR just tested:

  • On a clean XWiki 11.10.2 instance and it worked fine
  • On a subwiki on and it worked fine too

So my guess is that the content you put may have some influence. Could you tell me what content you’ve used? (on my side I’ve just put test).

ok I know. You had your wiki configured to use MD 1.1 and not 1.2. Seems there’s a problem with version 1.1. I’ve now updated your wiki to use MD 1.2 and it should work fine.

hmm actually I edited the syntax in the admin and saved but it seems there’s a problem and the chage is not taken into account. I need to dig more.

Seems it’s ok now. Could you retry?


Seems good, Thank you!

It would be awesome to be able to use markdown without switching one day. )

You mean to be able to choose the default syntax when creating pages?

It’s actually possible, see you just need to configure it :wink:

Please note that the Markdown syntax is not as powerful of the XWiki Syntax 2.1 syntax and you may experience some issues if you use the WYSIWYG editor (there are some constructs that cannot be expressed in MD syntax for ex, which will result in some content loss).

Not quite. I was thinking more about incorporating markdown into Xwiki syntax. Of course, there would be overheads and back compatibility issues, but result would bring so much of relief, that it worth it.

Could I somehow create such a request and back it? =)

Hi @searoso

Sorry but I don’t understand. XWiki is a polyglot wiki and it supports plenty of syntaxes (you can see them here:

Thus, XWiki supports Markdown as well as other syntaxes like the XWiki syntax 1.0, XWiki Syntax 2.0 and XWiki Syntax 2.1. Modifying the XWiki Syntax 2.1 (for example) to be the Markdown syntax wouldn’t make sense since that would no longer be the XWiki Syntax but the Markdown Syntax and this syntax is already supported.

I probably misunderstood something :slight_smile:


I’m don’t know purpose for Xwiki markup, so it’s hard for me to tell.

Personally I find wiki-syntax much more outdated and meaningless then markdown which is convenient and fancy. So it looks like a great basis for different systems. Sometimes it’s possible to augment several markups so that several syntax would be ok to use. Of course they will probably conflict with some expressions.

I see that wiki syntax is important to you, and wiki-community at large. But it would be interesting to know why.

I like markdown because it’s looks good and natural in use even if there is no support of it, and you just use it as plain text. Can’t say the same for wiki.

I don’t know how to say it: We already support Markdown!

This is completely the opposite :slight_smile: Markdown is a very limited syntax missing lots of features (that you need to express in HTML which is very bad syntax for writing documentation). So it’s very hard to do WYSIWYG with Markdown for example.

Regarding MD you might want to read:

But again XWiki already supports MD as the syntax.

I have no idea why you’d want XWiki to drop all the syntaxes it supports to only offer the MD syntax… What good would it do?


It is perfectly clear, and I’m grateful for your help on updating the extension to v.1.2.

I was talking on incorporating of markdown into Xwiki main syntax. So that when I type hashes, or equals row, or underscopes around, or do a quote with greater sign even in WYSIWYG it would read this and format accordingly. If it would understand it in code mode it would even better.

Nah… I’m totally not for this. This link you provided have an interesting angle that’s strange for me. It’s something I was trying to tell. We love markdown not for it’s expressiveness but for it’s ease. And it would be great to be able to do basic formatting with same tricks over maximum of more complicated syntaxes. That’s why author complains for so many flavor. For me it’s more kind a feature. Just absorb this simple rules of markdown into other markup, and people would become a bit happier.

@searoso I’ll repeat it once more: XWiki already support the Markdown markup. You can already use Markdown for basic formatting, etc.

Maybe your issues is that you’re using the WYSIWYG editor and you don’t use the markup editor which is why you don’t see it.

When you edit a page you can choose the markup for the page and you can also control what’s the default markup used for any new page, so you can have the Markdown markup as the default.

See for understanding how to edit pages and choose the editor to use.