*'''[https://en.wikipedia.org/wiki/VisualEditor VisualEditor]''' gives you the ability to edit without needing to learn wikitext markup, as is required by the default [[Help:Wikitext|Wikitext]] editor. Unlike that editor, VisualEditor will display the text being edited [[rich-text editor|https://en.wikipedia.org/wiki/WYSIWYG almost as if it were already published]]. This guide gives illustrated, step-by-step instructions on the editor's features, although it may occasionally lag behind the release of new ones.*Be aware that VisualEditor is still in development and thus has [https://en.wikipedia.org/wiki/Wikipedia:VisualEditor#Limitations known limitations] and bugs. For example, particularly for larger pages, VisualEditor can be slower than wikitext, and it is not available on talk/forum/discussion pages, where [[Help:Structured_Discussions|Structured Discussions]] tool is in place. While VisualEditor remains in development, you should [[Help:Wiki_Tutorial/Editing/VisualEditor#Saving changes|review your changes]] to ensure that the edits are those you intended.
}}
__TOC__
==Availability==
VisualEditor is available on the following types of pages (namespaces): *PLACEHOLDERHelp, Project, Fellow, 2020, User, File, Category, GeoJson, (Main)
| '''Linking tool:''' The chain icon is the [[Help:Wiki_Tutorial/Editing/VisualEditor#Editing links|linking tool]]. Clicking on it (usually after selecting some text) opens the [[Help:Wiki_Tutorial/Editing/VisualEditor#Editing links|link dialog]].
| '''{{int:visualeditor-toolbar-insert}}:''' The "{{int:visualeditor-toolbar-insert}}" menu may be different on some projects. Below is a list of '''all''' options that may appear.
* The "{{int:visualeditor-dialogbutton-media-tooltip}}" icon (a picture of mountains) opens the [[Help:Wiki_Tutorial/Editing/VisualEditor#Editing images and other media files|media dialog]].* The "{{int:visualeditor-dialogbutton-template-tooltip}}" icon (a puzzle piece) allows you to [[Help:Wiki_Tutorial/Editing/VisualEditor#Editing templates|edit templates]].
* The "{{int:visualeditor-commentinspector-tooltip}}" item (a speech balloon with a "!") allows you to insert comments that are not visible to readers; these comments can be seen only when in edit mode and are then indicated by an exclamation mark icon.
* The table item allows you to insert a table.
* The "{{int:visualeditor-mwgalleryinspector-title}}" icon (a set of photos) allows you to insert a gallery to the page.
* The "{{int:math-visualeditor-mwmathinspector-title}}" icon (Σ) opens the [[Help:Wiki_Tutorial/Editing/VisualEditor#Editing mathematical formulae|formula inserter dialog]].
* The "{{int:wikihiero-visualeditor-mwhieroinspector-title}}" icon (an [[:w:ankh|ankh]] symbol - ☥) allows you to enter the hieroglyphics inserter. (<s>See below.</s> Not mentioned again.)
* The "{{int:visualeditor-dialogbutton-referenceslist-tooltip}}" icon (three books) opens a dialog in which you can specify where will references be displayed to the reader. Usually this only needs to be done once on every page.
|-
| [[File:VisualEditor More Settings-en.png|thumb|400px|border|center]]
| The '''{{int:visualeditor-pagemenu-tooltip}}''' menu is to the left of the ''Publish changes'' button. On this menu there are options to adjust page settings, such as whether the page is a redirect, or how it is indexed; to [[Help:Wiki_Tutorial/Editing/VisualEditor#Editing categories|add, edit, or delete categories]]. You can also switch (one-way only) from VisualEditor to the classic wikitext source editor without losing the editing work you've done.
|}
| You can even mix ordered (numbered) and unordered (bullet) lists, if the list items have different indentations.
| To edit a page's settings, click to open the "{{int:visualeditor-pagemenu-tooltip}}" menu, in the toolbar, and select the "{{int:visualeditor-dialog-meta-settings-label}}" button.
| You can make a page a redirect to another page by checking the "{{int:visualeditor-dialog-meta-settings-redirect-label}}" checkbox, and then typing the name of the page to which you want to send the reader who tries to go to the page that you're editing.
At the bottom is the option to prevent page renames from updating this redirect. This is very rarely used.
| You can change whether the page shows a Table of Contents by selecting one of these three buttons. The default option is "{{int:visualeditor-dialog-meta-settings-toc-default}}", which shows a Table of Contents if there are three or more headings.
| Click "{{int:visualeditor-dialog-action-apply}}" when you're done editing the {{int:visualeditor-pagemenu-tooltip}} to return to the page editor.
|}
== Editing mathematical formulae ==
{| cellpadding="15"
| To add a new mathematical formula to the page, place your cursor where you want it to be inserted, and click on the "{{int:math-visualeditor-mwmathinspector-title}}" icon ("Σ") in the "{{int:visualeditor-toolbar-insert}}" menu on the toolbar.
| [[File:VisualEditor Formula Insert Menu-en.png|thumb|border|400px|center]]
|-
| colspan=2 | <hr />
|-
| A window will open in which you can type the formula, using LaTeX syntax. VisualEditor will update the formula as you type it, so you can see how it will look as you make changes. Once you are happy with the formula, click the "{{int:visualeditor-dialog-action-done}}" button.
| To edit an existing mathematical formula on the page, click on it and then click on the "Σ" icon that appears. This will open up the formula window, where you make changes.
==Moving pages==Moving a page with VisualEditor is functionally the same as moving it with the [[source editor]]; see [[HelpCategory:How to move a page]] for an introduction to moving Wiki help pages, or [[Wikipedia:Moving a page]] for more detailed instructions.== Keyboard shortcuts ==Many editors are used to entering wikitext directly, especially bold, italics and wikilinks. [[mw:VisualEditor/Portal/Keyboard shortcuts|Keyboard shortcuts]] allow to quickly insert similar formatting without having to use toolbar items. Here are the common general shortcuts in VisualEditor:{| style="text-align:center; margin:auto;" cellpadding="15"|-! PC shortcut! Action! Mac shortcut|-| colspan=3 | <hr />|-| {{Key press|Ctrl|B}}| Bold| {{Key press|Cmd|B}}|-| colspan=3 | <hr />|-| {{Key press|Ctrl|I}}| Italics| {{Key press|Cmd|I}}|-| colspan=3 | <hr />|-| {{Key press|Ctrl|K}}| Insert link| {{Key press|Cmd|K}}|-| colspan=3 | <hr />|-| {{Key press|Ctrl|X}}| Cut| {{Key press|Cmd|X}}|-| colspan=3 | <hr />|-| {{Key press|Ctrl|C}}| Copy| {{Key press|Cmd|C}}|-| colspan=3 | <hr />|-| {{Key press|Ctrl|V}}| Paste| {{Key press|Cmd|V}}|-| colspan=3 | <hr />|-| {{Key press|Ctrl|Z}}| Undo| {{Key press|Cmd|Z}}|}</div>