Enlaces
Los enlaces wiki, las anclas, las incrustaciones y las etiquetas conectan los archivos Markdown en una red. Los ejemplos de esta página muestran la sintaxis; sus destinos no existen en el manual, en tus propios archivos los enlaces abren el archivo de destino como pestaña.
Enlaces wiki
[[Destino]] enlaza un archivo por su nombre, sin ruta y sin extensión; la búsqueda cubre la carpeta del archivo y hasta dos niveles de subcarpetas. La extensión .md puede omitirse o escribirse.
[[Plan de proyecto]] abre plan de proyecto.md del ámbito de búsqueda.
[[Plan de proyecto|el plan]] muestra texto propio.
Si el nombre no acierta directamente con un archivo, se aplican dos alternativas: el acierto del índice sobre el ámbito de búsqueda y la resolución de alias mediante el campo de frontmatter aliases:; con varios candidatos pregunta un diálogo de selección. En celdas de tablas pipe, escapar la barra del texto mostrado como \|.
Anclas de encabezado y de bloque
Los enlaces pueden apuntar a un encabezado o a un bloque dentro del archivo de destino:
[[Plan de proyecto#Hitos]] salta al encabezado
[[Plan de proyecto#^decision-1]] salta al ancla de bloque
[[#Enlaces wiki]] ancla en el mismo documento
Las anclas de bloque se colocan con ^id al final de la línea y anclan el bloque envolvente (párrafo, elemento de lista, tabla, bloque de código):
Esta decisión es vinculante. ^decision-1
El ancla se presenta de forma distinta según la vista. La vista renderizada no la muestra en absoluto: allí el bloque es solo un destino de salto. El modo en vivo la sustituye por una marca discreta al final de la línea: al pasar el puntero se indica el identificador y, al hacer clic, el cursor se sitúa al final de la línea y se despliega el texto original para editarlo. Si el cursor ya está en esa línea, el ancla permanece visible como siempre. Que el modo en vivo muestre más que la vista renderizada es intencionado: un ancla es una dirección a la que apuntan otros documentos, y al reorganizar un documento conviene ver que existe. Si el mismo bloque tiene propiedades, su marca aparece al lado.
Los destinos de ancla rotos los marca el linter Markdown en el editor.
Enlaces Markdown a archivos
También los enlaces Markdown clásicos abren destinos .md como pestaña; las anclas funcionan igual. Los enlaces de ancla internos saltan dentro de la página — en vivo aquí: al capítulo Etiquetas.
[Plan](subcarpeta/plan-de-proyecto.md#hitos)
Nombres de archivo con espacios
Si un nombre de archivo contiene espacios, la notación depende del tipo de enlace. Los enlaces wiki llevan el espacio directamente:
[[Mi nota]]
Los enlaces Markdown y de imagen colocan el destino entre corchetes angulares o codifican el espacio como %20:
[Texto](<Mi nota.md>)
[Texto](Mi%20nota.md)
Un espacio sin corchetes angulares termina el destino, de modo que el enlace no se reconoce (CommonMark). Al renombrar un archivo, la actualización de enlaces escribe los destinos con espacios en la forma <…>; los destinos ya codificados con % conservan su forma.
Incrustaciones wiki
![[Destino]] incrusta contenido en lugar de enlazar:
![[imagen.png]] imagen, opcionalmente con ancho: ![[imagen.png|300]]
![[notas.md]] archivo Markdown como bloque renderizado
![[manual.pdf]] PDF en el visor interactivo
![[notas.md#Capítulo]] solo la sección bajo el encabezado
![[notas.md#^bloque]] solo el bloque anclado
Con anclas de bloque se incrusta el bloque envolvente completo (elemento de lista con sublistas, bloque de código, fila de tabla, cita). El Markdown incrustado se renderiza con su propia fuente como base; los enlaces internos se resuelven contra el archivo incrustado.
Dónde se busca el destino. La aplicación busca en tres pasos, igual para cada tipo de archivo: primero la ruta relativa a su propio archivo, después la escritura de las subpáginas y por último el simple nombre en toda el área. Así ![[imagen.png]] encuentra el archivo aunque esté en otra carpeta: no hace falta acertar la ruta. La búsqueda termina en la raíz del área: lo que quede fuera no se incrusta. Sin un área vinculada, el límite sigue siendo la carpeta del propio archivo.
Si un archivo Markdown lleva el mismo nombre que un adjunto, gana el archivo Markdown; escrito con su extensión (![[imagen.png]]) el caso es inequívoco. Las imágenes Markdown corrientes  no se ven afectadas: su escritura significa una ruta, no un nombre.
Vínculos entre áreas
Dos áreas pueden vincularse para que una referencia cruce el límite del área. Se configura en Configuración → Área actual → Vínculos entre áreas: allí se indican la carpeta de la otra área y un prefijo con el que se designará esa área.
El prefijo vale solo en esta área y solo en este sentido. Cómo se refiere la otra área a esta se define allí y puede ser distinto. Se permiten letras, dígitos, guion y guion bajo; las mayúsculas y minúsculas no importan.
En el texto el prefijo precede al destino:
[[@zt:Nota]] archivo «Nota» en el área vinculada «zt»
[[@zt:Carpeta/Nota]] destino por su ruta en el área vinculada
[[@zt:Nota#Capítulo]] con ancla, como en cualquier vínculo wiki
[[@zt:Nota|Etiqueta]] con un texto mostrado distinto
El destino se busca primero en la ruta indicada y, si allí no hay nada, por su nombre en toda el área vinculada, igual que un vínculo wiki dentro de la propia área. Al hacer clic, el destino se abre en la misma ventana.
Las plantillas del área vinculada pueden ofrecerse junto a las propias; hay un interruptor por vínculo. La selección de plantillas muestra entonces ambos conjuntos, y cada entrada ajena indica su procedencia. Sin ese interruptor, un vínculo no cambia el conjunto de plantillas.
Cuando un área vinculada no se encuentra
Al abrirse, un área comprueba sus vínculos, y un hallazgo nunca impide la apertura:
- La carpeta se ha movido: su ubicación superior es accesible, la carpeta no. Un aviso pide la nueva ruta. Mientras falte, las referencias con ese prefijo se consideran no válidas y se marcan en el editor.
- La ubicación de almacenamiento no está disponible, por ejemplo porque una unidad está desconectada. Entonces solo aparece un aviso: el vínculo se mantiene y nada se marca como no válido. Una unidad desconectada nunca destruye un vínculo.
La nueva ruta se introduce en el mismo lugar donde está definido el vínculo.
Qué no cruza el límite
Un vínculo entre áreas lleva hacia allá, no de vuelta. Deliberadamente no cruzan el límite:
- los retroenlaces: solo muestran referencias dentro de la propia área,
- el indicador «archivos sin referencias entrantes» de las estadísticas del área,
- la vista de grafo,
- la búsqueda en toda el área,
- y la actualización de vínculos al renombrar: al renombrar un archivo, las referencias desde un área vinculada quedan sin cambios. El editor las marca después como no válidas; esa es la red que las hace visibles.
Los vínculos entre áreas son una extensión y pueden desactivarse. Una referencia con prefijo queda entonces sin resolver, la comprobación al abrir no se realiza y los vínculos introducidos se conservan: lo que se desactiva es el efecto, no la entrada.
Etiquetas
#etiqueta en el texto y el campo tags: del frontmatter se reconocen como etiquetas; las barras crean jerarquías como #proyecto/markdown. Las etiquetas son clicables en la vista Lectura y el modo En vivo y filtran la barra lateral de etiquetas. Los códigos de color hexadecimales, los números puros, los enlaces de ancla y las almohadillas dentro de una dirección web quedan excluidos del reconocimiento: en https://example.org/#capitulo, #capitulo forma parte de la dirección y no es una etiqueta.
Estado: #proyecto/markdown #review
Renombrar una etiqueta
Un clic derecho en una entrada de la barra lateral de etiquetas renombra la etiqueta en todas sus apariciones del área: tanto en el texto como en el campo tags:, en todos los archivos, incluidos los que no están abiertos.
Las subetiquetas se mueven con ella. Si #proyecto pasa a ser #trabajo, entonces #proyecto/markdown pasa a ser #trabajo/markdown. Es intencionado y no un efecto secundario: las consultas tratan una etiqueta como prefijo de sus hijas, y renombrarla sin ellas rompería precisamente esas consultas. Una etiqueta que solo empieza por la misma palabra queda intacta: #proyectil no es hija de #proyecto, le falta la barra.
La vista previa precede a toda escritura. Enumera cada coincidencia con su línea, señala las subetiquetas que se mueven con ella y permite descartar coincidencias sueltas. Solo la confirmación en la barra sobre la lista escribe algo; cancelar lo deja todo como estaba.
La escritura se mantiene dentro del límite del área, y el estado anterior de cada archivo modificado queda en el historial de versiones, esté o no activado el historial. Un archivo con cambios sin guardar recibe el cambio en su pestaña en lugar de en el disco; un informe final nombra cada archivo y, donde algo no funcionó, el motivo.
Autocompletado
Al escribir en modo edición se abre un menú de sugerencias:
[[sugiere nombres de archivo y alias,[[Archivo#anclas de encabezado,[[Archivo#^IDs de bloque,#en el texto etiquetas conocidas.
Las flechas navegan, Intro o Tab selecciona, Esc cierra.
Mientras no se escriba nada tras [[, los archivos del área modificados más recientemente aparecen arriba, el más reciente primero. En cuanto se filtra, vuelve a mandar la calidad de coincidencia; la fecha de modificación solo decide entonces entre sugerencias del mismo rango.
Tras #, las etiquetas más usadas en el área aparecen arriba, la más frecuente primero; también aquí manda la calidad de coincidencia en cuanto se escribe algo, y entonces la frecuencia decide entre iguales. El número tras cada sugerencia la indica.
Al aceptar una sugerencia de archivo o de alias se escriben también los corchetes de cierre y el cursor queda detrás. Si ya están, no aparece un segundo par.
Barras laterales de la red
Tres secciones de la barra lateral muestran la red del archivo activo: Retroenlaces (enlaces entrantes, incluido «vía alias»), Enlaces salientes (todas las referencias salientes en orden de documento) y Etiquetas (todas las etiquetas del ámbito de búsqueda con su frecuencia). Los accesos figuran en la tabla de funciones.
Insertar una dirección en una selección
Cuando hay texto seleccionado y el portapapeles contiene una sola dirección, al pegar se crea un enlace a partir de ambos en lugar de reemplazar la selección. La selección Página del proyecto junto con la dirección https://example.org da como resultado:
[Página del proyecto](https://example.org)
Si la dirección contiene espacios o paréntesis, el destino se escribe entre corchetes angulares; una dirección www. recibe el prefijo https://:
[Entrada](<https://example.org/Titulo_(Extra)>)
Sin selección, con un contenido del portapapeles que no se reconoce como una sola dirección y dentro de áreas de código fuente se aplica el pegado normal. Un solo paso de deshacer revierte la conversión por completo. El acceso y el interruptor figuran en la tabla de funciones.