Tabla de Contenidos
Sintaxis de formato
DokuWiki admite un lenguaje de marcado sencillo, cuyo objetivo es que los archivos de datos sean lo más legibles posible. Esta página contiene toda la sintaxis que puedes utilizar al editar las páginas. Solo tienes que echar un vistazo al código fuente de esta página pulsando «Editar esta página». Si quieres probar algo, utiliza la página de pruebas. También puedes acceder fácilmente al marcado más sencillo a través de los botones rápidos.
Formato básico de texto
DokuWiki admite negrita, cursiva, subrayado y monospaciados . Por supuesto, puedes combinar todos ellos.
DokuWiki admite **negrita**, //cursiva//, __subrayado__ y ''de espaciado fijo'' . Por supuesto, puedes **__//''combinar''//__** todos ellos.
Ten en cuenta que los marcadores de formato deben rodear directamente el texto, por lo que ** negrita ** con espacios dentro de los marcadores no se aplicará el formato.
Puedes utilizar subíndice y superíndice.
También puedes utilizar <sub>subíndice</sub> y <sup>superíndice</sup>también.
Puedes marcar algo como eliminado también.
También puedes marcar algo como <del>eliminado</del> también.
Los párrafos se crean a partir de líneas en blanco. Si quieres forzar un salto de línea sin crear un párrafo, puedes utilizar dos barras invertidas seguidas de un espacio en blanco o del final de la línea.
Este es un texto con algunos saltos de línea
Ten en cuenta que las
dos barras invertidas solo se reconocen al final de una línea
o cuando van seguidas de
un espacio en blanco \\sin ellas, esto es lo que ocurre.
Este es un texto con algunos saltos de línea\\ Ten en cuenta que las dos barras invertidas solo se reconocen al final de una línea\\ o cuando van seguidas de\\ un espacio en blanco \\esto ocurre sin ellas.
Solo debes utilizar saltos de línea forzados si es realmente necesario.
Enlaces
DokuWiki admite varias formas de crear enlaces.
Externos
Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com. También puedes establecer el texto del enlace: This El enlace apunta a google. Las direcciones de correo electrónico como esta: andi@splitbrain.org también se reconocen.
DokuWiki admite varias formas de crear enlaces. Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com. También puedes establecer el texto del enlace: [[http://www.google.com|This El enlace apunta a google]]. Las direcciones de correo electrónico como esta: <[email protected]> también se reconocen.
Enlaces internos
Los enlaces internos se crean utilizando corchetes. Puedes indicar simplemente un pagename o utilizar un texto de enlace.
Los enlaces internos se crean utilizando corchetes. Puedes indicar simplemente una [[de:wiki:pagename]] o utilizar un [[de:wiki:pagename|texto de enlace adicional]].
Los nombres de las páginas de la wiki se convierten automáticamente a minúsculas; no se permiten caracteres especiales.
Puedes utilizar namespaces incluyendo dos puntos en el nombre de la página.
Puedes utilizar [[some:namespaces]] utilizando dos puntos en el nombre de la página.
Para obtener más información sobre los espacios de nombres, consulta namespaces .
También es posible enlazar a una sección específica. Solo tienes que añadir el nombre de la sección tras el símbolo de almohadilla, tal y como se hace en HTML. Esto enlaza a esta sección.
Esto enlaza a [[de:wiki:syntax#internal|esta sección]].
Notas:
- Los enlaces a páginas existentes se muestran con un estilo diferente al de nonexisting .
- Cuando se cambia el título de una sección, su marcador también cambia. Por lo tanto, no confíes demasiado en los enlaces entre secciones.
Interwiki
DokuWiki admite enlaces Interwiki . Se trata de enlaces rápidos a otras wikis. Por ejemplo, este es un enlace a la página de Wikipedia sobre wikis: Wiki .
DokuWiki admite enlaces [[doku>Interwiki]] . Se trata de enlaces rápidos a otros wikis. Por ejemplo, este es un enlace a la página de Wikipedia sobre wikis: [[wp>Wiki]] .
Recursos compartidos de Windows
También se reconocen los recursos compartidos de Windows como esta también se reconocen. Ten en cuenta que solo tienen sentido en un grupo de usuarios homogéneo, como una empresa Intranet .
Los recursos compartidos de Windows como [[\\server\share|esta]] también se reconocen.
Notas:
- Por motivos de seguridad, la navegación directa a recursos compartidos de Windows solo funciona de forma predeterminada en Microsoft Internet Explorer (y únicamente en la «zona local»).
- En Mozilla y Firefox, se puede habilitar mediante diferentes soluciones alternativas mencionadas en la Mozilla Base de conocimientos. No obstante, seguirá apareciendo una advertencia de JavaScript al intentar abrir un recurso compartido de Windows. Para eliminar esta advertencia (para todos los usuarios), añade la siguiente línea en
conf/lang/en/lang.php(más detalles en localización):- conf/lang/en/lang.php
<?php /** * Customization of the english language file * Copy only the strings that needs to be modified */ $lang['js']['nosmblinks'] = '';
Enlaces de imagen
También puedes utilizar una imagen para enlazar a otra página interna o externa combinando la sintaxis de los enlaces y imágenes (véase más abajo) de la siguiente manera:
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
Nota: El formato de imagen es la única sintaxis de formato aceptada en los nombres de los enlaces.
Toda la images_and_other_files de imagen y links de enlace (incluido el redimensionamiento de imágenes, imágenes internas y externas, URL y enlaces interwiki).
Notas al pie
Puedes añadir notas al pie 1) utilizando paréntesis dobles.
Puedes añadir notas al pie ((Esto es una nota al pie)) utilizando paréntesis dobles.
Estructuración en secciones
Puedes utilizar hasta cinco niveles diferentes de encabezados para estructurar tu contenido. Si tienes más de tres encabezados, se genera automáticamente una tabla de contenidos; esto se puede desactivar incluyendo la cadena ~~NOTOC~~ en el documento.
Título de nivel 3
Título de nivel 4
Título de nivel 5
Título de nivel 3
Título de nivel 4
Título de nivel 5
Utilizando cuatro o más guiones, puedes trazar una línea horizontal:
Archivos multimedia
Puedes incluir archivos externos e internos images con llaves. Opcionalmente, puedes especificar su tamaño.
Redimensionar a un ancho determinado:
Redimensionar a un ancho y una altura determinados (cuando la relación de aspecto del ancho y la altura especificados no coincida con la de la imagen, esta se recortará a la nueva relación antes de redimensionarla):
Imagen externa redimensionada:
Tamaño real: {{wiki:dokuwiki-128.png }}
Cambiar el tamaño a un ancho determinado: {{wiki:dokuwiki-128.png?50 }}
Cambiar el tamaño a un ancho y una altura determinados: {{wiki:dokuwiki-128.png?200x50}}
Imagen externa redimensionada: {{https://www.php.net/images/php.gif?200x50}}
Utilizando espacios en blanco a la izquierda o a la derecha, puedes elegir la alineación.
También puedes establecer la alineación de forma explícita con un ?left, ?right o ?center . Este parámetro tiene prioridad sobre la alineación por espacios en blanco mencionada anteriormente y se puede combinar con un tamaño.
Por supuesto, también puedes añadir un título (que la mayoría de los navegadores muestran como información sobre herramientas).
{{ wiki:dokuwiki-128.png |Este es el pie de foto}}
Para vincular una imagen a otra página, consulta Image Links más arriba.
Formatos multimedia compatibles
DokuWiki puede incrustar directamente los siguientes formatos multimedia.
| Imagen | gif, jpg, png |
| Vídeo | webm, ogv, mp4 |
| Audio | ogg, mp3, wav |
| Flash | swf |
Si especificas un nombre de archivo que no corresponde a un formato multimedia compatible, se mostrará como un enlace.
Al añadir ?linkonly se proporciona un enlace al archivo multimedia sin mostrarlo en la página
dokuwiki-128.png Esto es solo un enlace a la imagen.
Formatos alternativos
Lamentablemente, no todos los navegadores admiten todos los formatos de vídeo y audio. Para mitigar este problema, puedes subir tu archivo en diferentes formatos para garantizar la máxima compatibilidad con los navegadores.
Por ejemplo, fíjate en este vídeo mp4 incrustado:
{{de:wiki:video.mp4|Un vídeo divertido}}
Cuando subas un video.webm y video.ogv junto al archivo video.mp4, DokuWiki los añadirá automáticamente como alternativas para que el navegador pueda reproducir uno de los tres archivos.
Además, DokuWiki admite una imagen de «cartel» que se mostrará antes de que comience el vídeo. Esa imagen debe tener el mismo nombre de archivo que el vídeo y ser un archivo jpg o png. En el ejemplo anterior, un video.jpg funcionaría.
Listas
Dokuwiki admite listas ordenadas y desordenadas. Para crear un elemento de la lista, sangra el texto dos espacios y utiliza una etiqueta * para las listas no ordenadas o un - para las ordenadas.
- Esto es una lista
- El segundo elemento
- Puedes tener diferentes niveles
- Otro elemento
- La misma lista, pero ordenada
- Otro elemento
- Solo tienes que usar sangría para los niveles más profundos
- Eso es todo
* This is a list
* The second item
* You may have different levels
* Another item
- The same list but ordered
- Another item
- Just use indention for deeper levels
- That's it
Echa también un vistazo a las preguntas frecuentes sobre elementos de lista.
Conversiones de texto
DokuWiki puede convertir determinados caracteres o cadenas predefinidos en imágenes, otro texto o código HTML.
La conversión de texto a imagen se realiza principalmente para los emoticonos. Y la conversión de texto a HTML se utiliza para sustituciones tipográficas, aunque también se puede configurar para utilizar otro código HTML.
Conversiones de texto a imagen
DokuWiki convierte los caracteres emoticon más utilizados en sus equivalentes gráficos. Esos Smileys y otras imágenes se pueden configurar y ampliar. A continuación se ofrece una descripción general de los emoticonos incluidos en DokuWiki:
8-)
8-O
:-(
:-)
= )
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
m(
:?:
:!:
LOL
FIXME
DELETEME
Conversiones de texto a HTML
Tipografía: dokuwiki puede convertir caracteres de texto simples en sus entidades tipográficamente correctas. Aquí hay un ejemplo de caracteres reconocidos.
→ ← ↔⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..."
Lo mismo se puede hacer para generar cualquier tipo de HTML; solo hay que añadirlo al archivo de patrones.
Hay tres excepciones que no proceden de ese archivo de patrones: la entidad de multiplicación (640×480), las «comillas simples» y las «comillas dobles». Se pueden desactivar mediante una opción de configuración.
Citas
A veces querrás marcar un texto para indicar que se trata de una respuesta o un comentario. Puedes utilizar la siguiente sintaxis:
I think we should do it > No we shouldn't >> Well, I say we should > Really? >> Yes! >>> Then lets do it!
Creo que deberíamos hacerlo
No, no deberíamos
Bueno, yo digo que sí
¿En serio?
¡Sí!
¡Pues hagámoslo!
Tablas
DokuWiki admite una sintaxis sencilla para crear tablas.
| Título 1 | Título 2 | Título 3 |
|---|---|---|
| Fila 1 Columna 1 | Fila 1 Columna 2 | Fila 1 Columna 3 |
| Fila 2, columna 1 | algún colspan (fíjate en la doble barra vertical) | |
| Fila 3 Columna 1 | Fila 3 Columna 2 | Fila 3 Columna 3 |
Las filas de la tabla deben comenzar y terminar con un | para las filas normales o un ^ para los encabezados.
^ Encabezado 1 ^ Encabezado 2 ^ Título 3 ^ | Fila 1 Columna 1 | Fila 1, columna 2 | Fila 1, columna 3 | | Fila 2 Columna 1 | algún colspan (fíjate en la doble barra vertical) || | Fila 3 Columna 1 | Fila 3, columna 2 | Fila 3, columna 3 |
Para conectar celdas horizontalmente, basta con dejar la siguiente celda completamente vacía, tal y como se muestra arriba. ¡Asegúrate de que siempre haya el mismo número de separadores de celdas!
También es posible utilizar encabezados verticales en la tabla.
| Encabezado 1 | Encabezado 2 | |
|---|---|---|
| Encabezado 3 | Fila 1 Columna 2 | Fila 1, columna 3 |
| Título 4 | esta vez sin colspan | |
| Título 5 | Fila 2, columna 2 | Fila 2, columna 3 |
Como puedes ver, es el separador de celdas que precede a una celda el que determina el formato:
| ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Columna 2 | Fila 1, columna 3 | ^ Título 4 | Esta vez no hay colspan | | ^ Título 5 | Fila 2, columna 2 | Fila 2, columna 3 |
Puedes crear «rowspans» (celdas conectadas verticalmente) añadiendo ::: en las celdas situadas debajo de aquella a la que deben conectarse.
| Encabezado 1 | Título 2 | Título 3 |
|---|---|---|
| Fila 1 Columna 1 | esta celda se extiende verticalmente | Fila 1 Columna 3 |
| Fila 2, columna 1 | Fila 2, columna 3 | |
| Fila 3, columna 1 | Fila 2, columna 3 |
Aparte de la sintaxis «rowspan», esas celdas no deben contener nada más.
^ Encabezado 1 ^ Título 2 ^ Título 3 ^ | Fila 1 Columna 1 | esta celda se extiende verticalmente | Fila 1 Columna 3 | | Fila 2, columna 1 | ::: | Fila 2, columna 3 | | Fila 3, columna 1 | ::: | Fila 2, columna 3 |
También puedes alinear el contenido de la tabla. Solo tienes que añadir al menos dos espacios en blanco en el extremo opuesto del texto: añade dos espacios a la izquierda para alinear a la derecha, dos espacios a la derecha para alinear a la izquierda y al menos dos espacios en ambos extremos para centrar el texto.
| Tabla con alineación | ||
|---|---|---|
| derecha | centrado | izquierda |
| izquierda | derecha | centro |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Así es como se ve en el código fuente:
^ Tabla con alineación ^^^ | derecha| centrado |izquierda | |izquierda | derecha| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Nota: No se admite la alineación vertical.
Sin formato
Si necesitas mostrar el texto tal y como se ha escrito (sin ningún formato), enmarca el área con <nowiki> o, aún más sencillo, con dos signos de porcentaje %%.
Este es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formato**, pero no se aplica nada. Lo mismo ocurre con //__este__ texto// con un emoticono ;-).
<nowiki> Este es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formato**, pero no se aplica nada. </nowiki> Lo mismo ocurre con %%//__este__ texto// con un emoticono ;-)%%.
Bloques de código
Puedes incluir bloques de código en tus documentos, ya sea sangrándolos al menos dos espacios (como en los ejemplos anteriores) o utilizando las etiquetas <code> or <file>.
This is text is indented by two spaces.
This is preformatted code all spaces are preserved: like <-this
This is pretty much the same, but you could use it to show that you quoted a file.
Esos bloques se han creado a partir de esta fuente:
Este texto está sangrado dos espacios.
<code> This is preformatted code all spaces are preserved: like <-this </code>
<file> This is pretty much the same, but you could use it to show that you quoted a file. </file>
Resaltado de sintaxis
dokuwiki puede resaltar el código fuente, lo que facilita su lectura. Utiliza el GeSHi Generic Syntax Highlighter, por lo que es compatible con cualquier lenguaje que admita GeSHi. La sintaxis utiliza el mismo código y los mismos bloques de archivo descritos en la sección anterior, pero en esta ocasión el nombre del lenguaje cuya sintaxis se va a resaltar se incluye dentro de la etiqueta, p. ej.: <code java> or <file java>.
/** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Display the string. } }
The following language strings are currently recognized: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic
There are additional advanced options available for syntax highlighting, such as highlighting lines or adding line numbers.
Downloadable Code Blocks
When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:
<file php myexample.php> <?php echo "hello world!"; ?> </file>
- myexample.php
<?php echo "hello world!"; ?>
Si no quieres que se resalte nada, pero sí quieres un archivo descargable, especifica un guion (-) como código de lenguaje: <code - myfile.foo>.
Agregación de fuentes RSS/ATOM
dokuwiki puede integrar datos de fuentes XML externas. Para analizar las fuentes XML, SimplePie se utiliza. Todos los formatos que admite SimplePie también se pueden utilizar en DokuWiki. Puedes modificar la visualización mediante varios parámetros adicionales separados por espacios:
| Parámetro | Descripción |
|---|---|
| cualquier número | se utilizará como número máximo de elementos que se mostrarán; el valor por defecto es 8 |
| invertir | Mostrar primero los últimos elementos del feed |
| author | Mostrar los nombres de los autores de los elementos |
| date | mostrar las fechas de los elementos |
| description | mostrar la descripción del elemento. Se eliminarán todas las etiquetas HTML |
| nosort | no ordenar los artículos del feed |
| n[dhm] | periodo de actualización, donde d=días, h=horas, m=minutos. (p. ej., 12h = 12 horas). |
El periodo de actualización predeterminado es de 4 horas. Cualquier valor inferior a 10 minutos se considerará como 10 minutos. dokuwiki intentará, por lo general, proporcionar una versión en caché de una página; obviamente, esto no es adecuado cuando la página contiene contenido externo dinámico. El parámetro indica a dokuwiki que vuelva a generar la página si ha transcurrido más de período de actualización desde la última vez que se renderizó la página.
Por defecto, el feed se ordenará por fecha, con los elementos más recientes primero. Puedes ordenarlo de forma que los más antiguos aparezcan primero utilizando el reverse , o mostrar el feed tal cual con nosort.
Ejemplo:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
- An AI-Supervised Remote Exam Went So Badly That 58,000 Students Must Retake It por BeauHD (2026/08/03 23:00)
- Schools Are Ditching Chromebooks For MacBooks By the Thousands por BeauHD (2026/08/03 22:00)
- Microsoft Is Bringing Xbox 360 Games to PC por BeauHD (2026/08/03 21:00)
- Microsoft CEO Touts His Own DIY AI Project To Wall Street and His 20 Million Followers por BeauHD (2026/08/03 20:00)
- Apple's iCloud File Sharing Left Ex-Employees With Access to Secret Documents por BeauHD (2026/08/03 19:00)
Macros de control
Hay algunos elementos sintácticos que influyen en cómo DokuWiki representa una página sin generar ningún resultado por sí mismos. Están disponibles las siguientes macros de control:
Macro «^ » ^ Descripción |
| ~~NOTOC~~ | Si se encuentra esta macro en la página, no se creará ninguna tabla de contenidos |
| ~~NOTOC~~ | DokuWiki almacena en caché toda la salida de forma predeterminada. En ocasiones, esto puede no ser deseable (por ejemplo, cuando se utiliza la sintaxis <php> anterior), añadir esta macro obligará a DokuWiki a volver a generar la página en cada llamada |
Complementos de sintaxis
La sintaxis de DokuWiki se puede ampliar mediante complementos. El uso de los complementos instalados se describe en sus respectivas páginas de descripción. En esta instalación concreta de DokuWiki están disponibles los siguientes complementos de sintaxis:
- Gallery Plugin 2024-04-30 por Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - include plugin 2025-07-22 por Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
Functions to include another page in a wiki page - Numbered Headings 2023-09-12 por Satoshi Sahara
Prepend tiered numbers as indexes for hierarchical headings - Pagelist Plugin 2023-08-27 por Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way - PageQuery Plugin 2025-03-04 por Mark C. Prins, previously Symon Bent
Search for (fulltext) and list wiki pages, sorted and optionally grouped by name, date, creator, abc, etc. in columns. Insert the pagequery markup wherever you want your list to appear. E.g.{{pagequery>[query;fulltext;sort=key:direction,key2:direction;group;limit=??;cols=?;inwords;proper]}} [..] = optional - tagsections plugin 2026-01-21 por i-net software / Gerry Weißbach
Add tags to sections using the taggadd gui - Tag Plugin 2023-10-17 por Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
tag wiki pages - Video Sharing Site Plugin 2025-12-10 por Andreas Gohr
Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}} - Wrap Plugin 2026-06-02 por Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.


