Help test the first visual editor developer prototype

Translate This Post

The development of a Visual Editor is one of the Foundation’s top priorities for the upcoming year, as laid out by the 2011-2012 Annual Plan.  There is plenty of evidence that wiki-markup is a substantial barrier that prevents many people from contributing to Wikipedia and our other projects.  Formal user tests, direct feedback from new editors, and anecdotal evidence collected over the past several years have made the need for a visual editor clear.
Developing a web-based visual editor is an extremely complex task.  It is perhaps the most challenging technical project ever undertaken in the history of MediaWiki development.  Here are some of the characteristics that make this project unique:

  • We have to support editing in both the new way (via the Visual Editor) and the traditional way (via wiki markup).  This is important since it’s what our communities have used for more than 10 years: We can’t completely change the way they do their work overnight.  We need to, however, simultaneously support potential editors who are not comfortable with wiki markup.  So any editing system will need to be able to go back and forth between the Visual Editor and wiki markup with minimal, if any, disruption to the end user.  We will have to perform back-and-forth transformations without breaking things.  Anyone who has used an editor that has both “visual” and “html” modes should have a feeling for the challenges, but it’s even harder with wiki markup, because:
  • Wiki markup is enormously expressive, complex and complicated, and there’s a huge amount of content which uses every facet of this markup language. Wikipedia articles employ a rich set of layout features, including images, tables, citations, mathematical formulas, “infoboxes” and other dynamically loaded templates which preserve a consistent look and feel for certain information, and many other elements that enable a compelling and educational reader experience (see the article on Calculus as an example).  Supporting compatibility with the full breadth of these features is an enormous technical challenge.

Over the past several months, the engineering team at WMF has made a lot of progress in developing this visual editor.  Today, we’d like to share the first prototype of a basic editing surface which supports the translation of what’s on the screen into wiki markup.  The demo, which can’t yet save or edit documents, supports both basic formatting (e.g., bold, italics, section heading) as well as many of the required features that people take for granted (e.g., cut/paste and undo/redo). However, it’s still very fragile, and you may easily end up with an unusable document. In the best case scenario, you can use it to generate valid wiki markup that you can copy and paste into an edit box on any MediaWiki wiki.
This version of Visual Editor should support most of the modern browsers but was tested mostly on Firefox, Chrome and IE9. We do support IE8 as well, but not IE7 (yet). The editor isn’t internationalized yet, but will be with the next release.

Try the visual editor sandbox

You can view the demo and see the wikitext translation by visiting the visual editor sandbox on and playing around with any of the articles available for pre-loading.

Image (1) visual-editor-demo.png for post 8452
Manipulation of an example document, showing the link editor.

Image (2) visual-editor-demo-2.png for post 8452
Using the debugging tools in the top right, you can switch to side-by-side view of different content representations, including wikitext (icon with square brackets), which are dynamically updated as the text on the left changes.

We would love to get your input on our progress.  Please leave us comments by clicking on the “Leave Feedback” in the upper right hand corner of the demo, which will place your feedback on this page.  Thoughts on which tasks this interface makes easier or harder compared to your current workflow would be particularly helpful.  We’re very excited to share this progress and look forward to your feedback.
Where do we go from here? From here on, we will iteratively release features, bug-fixes, and updates.  We’ll continue to make this tool useful for more real-world use cases, and tick off additional features: creating pages, saving them, editing existing pages or sections, adding/removing images, editing data in templates, editing tables. . .the list goes on.
Our goal is to enable real-world editing of a subset of content soon, but it’ll still be some time until we can serve all the needs of even a small wiki community, let alone Wikipedia’s. Currently we’re targeting June 2012 for first production use at scale, either on a smaller wiki or a section of a larger one. It’s the biggest and most important change to our user experience we’ve ever undertaken, and we look forward to your help in making it happen.
— The Visual Editor Team, Wikimedia Foundation
Trevor Parscal, Inez Korczyński, Neil Kandalgaonkar, Roan Kattouw, Brion Vibber, Gabriel Wicke

Archive notice: This is an archived post from, which operated under different editorial and content guidelines than Diff.

Can you help us translate this article?

In order for this article to reach as many people as possible we would like your help. Can you translate this article to get the message out?

Inline Feedbacks
View all comments

As far as WikiText translation has to go, this definitely has a ways to go. But as far as WYSIWYG interfaces, this is one of the nicest I’ve seen so far.

Left feedback.
On a different subject … what’s happening with Liquid Threads?
I saw it on the strategy wiki a year ago but I haven’t seen any progress reports on it in the technology blog since.

This is beautiful. Thanks for working on this. I look forward to seeing what you guys will come up with as the next steps.

Excellent work guys! I’m looking forward to see how this project progresses. Love the clean and pleasent design of it.

Why are there HTML and JSON views? A good reason for the use of wikitext apart from its relative simplicity (compared to full-scaled languages like HTML) is the fact the pages cannot be manipulated easily by various tags which could mess up the whole thing. Sure, I guess it can’t be edited in HTML directly (good move) but I don’t see the point of having the HTML source there, that would simply confuse people. Why not just leave the “view source” button at the top and maybe have a drop-down to include JSON as well? This is needlessly confusing to… Read more »

Is there a branch under, or is the code held on some other source control system?

Ioannis, these are just for debugging purposes–this is still a developer prototype. They’ll go away or get stashed away eventually.
Stephan, it’s an extension sitting in trunk at:
You can use the extension distributor to download:
Or follow the checkout instructions here:

Good job! My normal mode is to carp. I don’t often say that to software developers. Very intuitive to use. I like the way you have a drop down menu at the cursor for the commonest functions: B I and link.
One small issue: when making a link, the context box asks for “Page title” when what it really means is usually referred to as the page url. Unless there’s some special reason for using “title,” I’d suggest changing that to “url.”

Kudos to the MediaWiki team for tackling this issue. I can testify that it is very challenging task. TWiki has a WYSIWYG editor for several years now where users have a choice to edit in raw wiki markup or with the visual editor. The back and forth translation between TML (TWiki markup) and WYSIWG HTML editor is very challenging. We have a somewhat usable solution, but we still have some issues left where the wiki markup may look somewhat different after a TML => HTML =>TML round trip. Visually OK to look at, but the revision history shown too many… Read more »

@quixote: If you dont like “Page title”, how about just “Link to” ? “Url” is a bit technical when there’s no reason to be, I think the aim has to be reduced the barrier to entry as much as possible to encourage the widest possible uptake.

It would be much helpful if the edit tool bar having buttons for all Wiki operations like [Citation], References, {{}} tags, templates and so on. A partial conversion of WYSIWYG wouldn’t be effective. Go fully WYSIWYG.

Ernesto: WYSIWYG editors tend to create bad code, making it impossible for advanced users to easily edit. It would appear this has been averted so far by limiting the amount of functions that the editor has. If the visual editor is only intended for casual users, then templates won’t need to be included.

Awesome, awesome, awesome. I am so happy to see this progress. You guys are doing great job tackling a really hard issue. You’re going to have a HUGE positive impact on editing once this goes live. Keep up the good work!

Great work guys, I’ve been following the work on the visual editor for quite some time and I must say you’ve managed to do an amazing job with brilliant ideas for tackling the challenges of this feature.
@RedZ, actually they seem to be working on visual edition of templates but it won’t be full wysiwyg for obvious reasons.

As far as enwiki goes, by far the most important aspect – indeed, the entire point – of a “visual editor” is helping to make referencing easier. For new-user submissions, references are really the only thing we care about. And that is the thing everyone struggles with. Everything else – wiki-links, formatting, infoboxes, headings, etc. – can be sorted out reasonably easily by other editors. The one, single thing we cannot fix is, lack of good references. So whilst I can see this might help make things more approachable, I think it’s missing the crucial problem, the single hurdle that… Read more »

[…] Editor für Wikipedia erleichtert das Erstellen von Artikeln Wikipedia lässt von seinen Usern einen neuen visuellen Editor testen, mit dem man auch ohne weitere Vorkenntnisse neue Wikipedia-Artikel erstellen kann. Mit dem neuen […]

This is surely not the first visual editor for mediawiki. There are numerous (though not public) MediaWikis with integrated WYSIWG editors. We are making use of it already.

[…] des articles ! [page de test]  Les premiers essais sur un wiki auront lieu vers Juin 2012 [les explications] Les autres conséquences sont discutées en commentaire de l’article et sur notre […]

Forgive the all caps but it’s the only way I know hoe to express what I’m thinking right now.
Couple of things I would still like to see are a way to create wikitables, insert images, references etc in a way similar to the B, ”I” and paragraph functions already present.
Can’t wait to show this to all my geeky friends.

PS: could you include a spell check function for those of us who contribute to english wikipedia but aren’t native english speakers. It seems like an easy enough thing to do for a computer but a very anoying task when you have to copy paste your edits into an external aplication to filter for mistakes.

Where can I report bugs?
1. Put the cursor at the end of ‘errors’ in the second paragraph.
2. Ctrl-shift-cursorleft.
3. Press key ‘x’
Instead of replacing ‘errors’ with ‘x’ the editor replaces it with ‘xs’.

That is truly awsome!
I wonder if there will be any way to create plugins for this new editor. It would be wonderful to be able to plug in our recommender tool, Sztakipeda:

@Nick J.: “Link to” is much better. You’re quite right!

Nice to see progress on this oh so hard challenge ! 🙂 And oh so much needed ! I am impatient to be able to make a little change on some word without having to swim in all the wikisoup surrounding it. Please make the easy buttons mark up content as (X)HTML elements “strong” — strong emphasis — and “em” — emphasis —. These are the accessible and semantic elements that are almost always the correct ones when insisting on some content. A contrario, the elements “b” — bold — and “i” — italic — are very rarely the correct ones, they are not… Read more »

[…] Wikimedia rozpoczęła wstępne testowanie pierwszego prototypu wizualnego edytora dla Wikipedii. Aktualnie jest to najwyższy priorytet rozwojowy, w kierunku edycji artykułów, który ma […]

[…] 以前提到过,FCKeditor出了一个mediawiki编辑器的扩展,不过现在FCKeditor已经换成了CKeditor,因此这个扩展也不再被支持,官网上已废止。但是基金会的工程师们也没闲着,正在开发自己的可视化编辑器,邀请测试,并给反馈意见,更好的改进。 […]

I run wikis for NASA. I would highly suggest that folks within WikiMedia seriously have a look at Atlassian Confluence 4.0, which was just released a few months ago. Confluence has had a Rich Text Editor for years, but kept an ability for end users to edit via wiki markup. For version 4.0 they have completely eliminated the wiki markup editor, because they switched from wiki markup on the backend to custom XHTML which end users, even experts, would have great trouble manipulating. The big reason for eliminating the wiki markup was round trip issues, which are problems which occur… Read more »

[…] prevents many people from contributing to Wikipedia and our other projects,” explains a Wikimedia blog post from Tuesday. “Formal user tests, direct feedback from new editors, and anecdotal evidence […]

[…] prevents many people from contributing to Wikipedia and our other projects,” explains a Wikimedia blog post from Tuesday. “Formal user tests, direct feedback from new editors, and anecdotal evidence […]

[…] nouveau prototype d’éditeur visuel (à tester ici), mis en ligne mardi 13 décembre, pourrait inverser la […]

[…] Wikimedia Foundation podaje na swoim blogu, że stworzenie wizualnego edytora jest być może najtrudniejszym projektem technicznym w historii rozwoju MediaWiki. Twórcy internetowej encyklopedii proszą użytkowników, by uczestniczyli oni w procesie testowania i dzielili się swoimi spostrzeżeniami. Wikimedia będzie stopniowo wydawać łatki i aktualizacje aż do wprowadzenia finalnej wersji narzędzia. […]

This is great, and long overdue. Fantastic work.
I know there’s still lots to do but is there any policy towards smartphones? Even though mobile browsers are not listed in the supported list, my android phone can work passably with it, however text selection seems impossible on the touch screen. If it’s likely to be out of scope, would the direct manipulation interface be hidden by default with an option to try it? (this strikes me as the best approach for all unsupported browsers, even non-mobile)

[…] editor gráfico de verbetes Posted by dpkg on Dezembro 16th, 2011 A Fundação Wikimedia está convidando os usuários a testar o primeiro protótipo de um editor gráfico para a Wikipedia. O desenvolvimento de um editor […]

[…] umgehen, zu leisten bereit sind. Auf Dauer sind das nicht genug. Daher ist es nicht verwunderlich, dass die Wikimedia-Foundation an einem Wysiwyg-Editor, einem visuellen Editor für das Verfassen neuer Wikipedia-Einträge arbeitet. Verwunderlich ist […]

[…] (typeof(addthis_share) == "undefined"){ addthis_share = [];} Wikimedia Foundation meminta pengguna untuk mencoba prototipe pertama Visual Editor untuk Wikipedia. Pengembangan editor yang dapat […]

[…] Wikimedia Foundation podaje na swoim blogu, że stworzenie wizualnego edytora jest być może najtrudniejszym projektem technicznym w historii rozwoju MediaWiki. Twórcy internetowej encyklopedii proszą użytkowników, by uczestniczyli oni w procesie testowania i dzielili się swoimi spostrzeżeniami. Wikimedia będzie stopniowo wydawać łatki i aktualizacje aż do wprowadzenia finalnej wersji narzędzia. […]

Congratulations on getting this far. But what about citations? Surely we don’t want to go back the bad old days of inexperienced contributors adding unsourced stuff that other people have to fix. That would accelerate the decline in experienced editors, and new editors aren’t likely to stick around if their contributions are greeted with a blizzard of “fact”, “says who?” and “uw-unsourced” messages. Sorry to pour cold water, but a visual editor that encourages unsourced content would be a disaster for Wikipedia, not a triumph. – ~~~~

[…] Mitteilung zum Visual Editor (Quelle) […]

Fantastic! I’m customizing mediawiki for a huge intranet wiki of fifty thousand users and this Visual Editor is exactly what we need. It will make the contribution easier and economize a lot of training. I would like to put this into production as soon as you have a beta version. This is so good that we won’t wait for the stable version. Eventual bugs are better than have to invest in training thousands of people in Wiki markup in order to use WikiEditor. Is there already a trunk version that we could install as an alternative editor in localsettings.php for… Read more »

It looks fantastic. Any chance of integration with for real-time editing and no more edit conflicts?