Saltar al contenido

Referencia cruzada (ancla con nombre) en Markdown

Este escrito ha sido probado por expertos para que tengas la garantía de la exactitud de nuestro tutorial.

Solución:

Take me to [pookie](#pookie)

debería ser la sintaxis de rebajas correcta para saltar al punto de anclaje llamado pookie.

Para insertar un punto de anclaje de ese nombre, use HTML:


A Markdown no parece importarle dónde coloca el punto de anclaje. Un lugar útil para ponerlo es en un encabezado. Por ejemplo:

### This is the Heading

funciona muy bien (Haría una demostración aquí, pero el renderizador de SO elimina el ancla).

Nota sobre las etiquetas de cierre automático y id= versus name=

Una versión anterior de esta publicación sugería usar usando la sintaxis de cierre automático para XHTML y usando el id attribute en vez de name.

XHTML permite que cualquier etiqueta esté ‘vacía’ y ‘autocerrada’. Es decir, es abreviatura de , un par de etiquetas coincidentes con un cuerpo vacío. La mayoría de los navegadores aceptarán XHTML, pero algunos no. Para evitar problemas entre navegadores, cierre la etiqueta explícitamente usando como se recomienda anteriormente.

Finalmente, el attribute name= estaba en desuso en XHTML, así que originalmente usé id=, que todos reconocen. Sin embargo, HTML5 ahora crea una variable global en JavaScript cuando se usa id=, y esto puede no ser necesariamente lo que desea. Entonces, usando name= ahora es probable que sea más amigable.

(Gracias a Slipp Douglas por explicarme XHTML y a Nailer por señalar el efecto secundario de HTML5; consulte los comentarios y fabricante de clavosLa respuesta de para más detalles. name= parece funcionar en todas partes, aunque está obsoleto en XHTML).

En bitbucket.org, la solución votada no funcionaría. En cambio, cuando se usan encabezados (con ##), es posible hacer referencia a ellos como anclas con el prefijo #markdown-header-my-header-name, donde #markdown-header- es un implícito prefix generado por el renderizador, y el resto es el título del encabezado en minúsculas con guiones en lugar de espacios.

Ejemplo

## My paragraph title

producirá un ancla implícita como esta

#markdown-header-my-paragraph-title

La URL completa antes de cada referencia de anclaje es opcional, es decir

[Some text](#markdown-header-my-paragraph-title)

es equivalente a

[Some text](https://bitbucket.org/some_project/some_page#markdown-header-my-paragraph-title) 

siempre que estén en la misma página.

Fuente: https://bitbucket.org/tutorials/markdowndemo/overview (edite la fuente de este archivo .md y vea cómo se hacen los anclajes).

Utilizar una name. Usando un id no es necesario en HTML 5 y creará variables globales en su JavaScript

Consulte la especificación de HTML 5, 5.9.8 Navegación a un identificador de fragmento: ambos id y name son usados.

Es importante saber que la mayoría de los navegadores todavía convierten los ID en variables globales. Aquí hay una prueba rápida. Usando un name evita la creación de globales y cualquier conflicto que pueda resultar.

Ejemplo usando un nombre:

Take me to [pookie](#pookie)

Y el ancla de destino:

### Some heading

Nos encantaría que puedieras dar visibilidad a este escrito si te fue de ayuda.

¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)



Utiliza Nuestro Buscador

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *