%RPLC-TITULO-DEL-DIALOGO

   
Buscar [QUE_BUSCAR]:
%RPLC-CONTENIDO-DEL-DIALOGO

Documentación de ayuda

:  
:  
 
:  
Elija el tipo de filtro que desea aplicar a la lista de artículos de ayuda
Busque y elija un propósito para el que pueda haber ayuda escrita.
Busque y elija el tipo de objeto a usar como filtro
Busque y elija el tópico de documentación a usar como filtro
:  
Elija el campo en que desea buscar. Fije una condición de búsqueda y escriba un texto breve. No use comillas ni caracteres especiales. Se admiten letras tildadas y ñ

Markdown es una herramienta de conversión de texto a HTML para escritores web. Hace posible escribir, usando texto plano, textos fáciles de leer, con marcas que sin alterar su sentido, permiten convertirlo en XHTML (o HTML) estructuralmente válido; de modo que pueda ser presentado dotado de un aspecto gráfico que mejore su apariencia y legibilidad.
Es ideal para facilitar la preparación de textos, en línea, con un alto nivel de seguridad.

Sintaxis básica:

  • Encabezados: usar entre 1 y 6 almoadillas sucesivas para representar los elementos h1 a h6 correspondientes.
  • Citaciones: usar una cuña (>) signo mayor que al iniciar el renglón, seguido de un espacio.
  • Énfasis: Insertar el texto a resaltar entre asteriscos o guiones bajos usando entre 1 y tres a cada lado así 1 = itálicas, 2 = negrilla y 3 = itálicas + negrilla.
  • Reglas horizontales Dejar un renglón libre antes, escribir tres o más guiones al iniciar el nuevo renglón y terminarlo escribiendo dos espacios antes de saltar a la nueva línea.
  • Listas:
    • Lista simple con viñetas: (como esta) iniciar cada renglón con arterisco seguido de espacio "* ".
    • Lista numerada: iniciar cada renglón con un dígito seguido de un punto y un espacio "1. ".
    • Lista anidada: iniciar con un espacio antes del indicador de lista " * ".
  • Código
    • En línea insertar el texto de programa entre acentos graves si se desea en línea. `$variable = valor`.
    • En bloque Iniciar el bloque luego de dos saltos de línea con cuatro espacios, sangrar todas las líneas con al menos 4 espacios y agregar 4 extra por cada nivel de sangrado adicional y terminarlo con salto de línea doble.
  • Enlaces
    • En línea Se debe usar una combinación de llaves y corchetes así: [Texto del enlace](dirección_de_destino) u, opcionalmente, [Texto del enlace](dirección_de_destino "valor del atributo title del enlace"). Nótese que la dirección no está entre comillas .
    • Usando referencias En este caso el enlace se presenta mediante un doble par de corchetes [Texto del enlace] [id] y el id se define en otro lugar del texto, preferiblemente al final, así: [id]: dirección_de_destino "atributo title opcional".
    • Urls relativas En el caso específico de Sintetice las direcciones internas deben presentarse usando el prefijo [BASELNK] sin espacios. Por ejemplo el enlace que traería a esta página podría escribirse así [Sintáxis markdown]([BASELNK]ayuda/4 "ayuda: Sintaxis del lenguaje de marcación Markdown") y su resultado es: Sintáxis markdown; deslice el mouse sobre el enlace para ver el texto emergente.
  • Imágenes Casi igual que las direcciones de enlaces pero usando una admiración antes del primer corchete. Debe conocer su ubicación relativa al directorio público y emplear el prefijo para presentar direcciones relativas citado arriba.
    nota: Las imágenes se muestran sangradas a izquierda con una altura máxima de 200px. Si las necesita diferentes debe sobreescribir es estilo:

    .markdown-block img { 
        width: auto; height: auto; max-height: 200px; float: left; 
        padding: .5em; padding-left: 0;
    }  

    en la configuración del campo de texto del tipo de contenido en el que desea hacer la modificación.

Restricciones

  • No se admiten secuencias de escape típicas. Ningun texto puede contener el caracter barra inclinada inversa (backslash) que es soportado por mardown. Si lo contiene toda la entrada de texto será marcada como ilegítima por el validador y eventualmente borrada en el navegador. En su lugar, se ofrece soporte limitado para la representación [ ESC ] sin espacios interiores. El analizador de textos busca la cadena y la reemplaza por la barra inclinada antes de entregarla al intérprete de markdown.
  • Sólo se admiten los caracteres empleados en la escritura de textos literarios en español. Muchos caracteres especiales son rechazados y su presencia hace que el texto completo sea rechazado. (Paranóia del equipo de desarrollo ante las inyecciones sql: se decidió que tiene más sentido rechazar algo que será tremendamente inusual que tratar de escribir soporte e incluir utilidades de seguridad complementaria, costosas, para aceptar algo que posiblemente no se use nunca.)

Tokens auxiliares

Sintetice ha agregado un pequeño juego de locuciones (tokens) para mejorar el aspecto y asegurar que los enlaces relativos no se rompan. Su sintaxis es muy simple: [TOKEN] escribir el toquen entre corchetes, sin espacios intermedios. En esta página se ha anotado el uso de dos de ellos: ESC y BASELNK. La lista completa se presenta en la página de ayuda Tokens Tokens extensores del lenguaje de marcación Markdown

Acerca de Markdown

  1. La documentación oficial se encuentra en daringfireball.net/projects/markdown/.
  2. Parser empleado Parsedown.

Extensión de Markdown

  1. La versión actual de Sintetice ofrece soporte para el uso de la extensión de Mardown PHP Markdown Extra. Puede consultar su documentación oficial en su sitio oficial