Manual del editor de mensajes de bandaancha.eu

Para formatear tus mensajes utiliza este sencillo lenguaje inspirado en el mismo sistema que utilizan WhatsApp o Telegram y que hemos extendido tomando ideas de Markdown. Le hemos llamado MarkCode.

No abuses del formato, por ejemplo utilizándolo para hacer el texto de tu mensaje más grande y resaltar sobre los demás.

Resumen

Utilizamos algunos carácteres especiales para marcar fragmentos de texto e indicar su formato. Por ejemplo, flanqueando un texto con sendos asteriscos * le damos formato de *letra en negrita*.

Aquí tienes un resumen de todas las posibilidades:

Aún hay más:

Y algunos elementos avanzados:

Sigue leyendo para conocer todos los detalles del lenguaje y sacarle el máximo partido al enviar tus mensajes.

• 1 Resumen
• 2 Formatos de letra
• 3 Enlaces
• 4 Menciones de usuarios
• 5 Imágenes
  • 5.1 Tamaño y recorte
  • 5.2 Referencias
• 6 Vídeos
• 7 Encabezados
  • 7.1 Título secundario de sección
• 8 Listas
• 9 Citas
• 10 Tablas
  • 10.1 Encabezados y alineación de columnas
  • 10.2 Extensión de celdas
• 11 Bloques de código
• 12 Barra horizontal
• 13 Pie de foto
• 14 Elementos especiales
  • 14.1 Tabla de contenidos
  • 14.2 Consejo, advertencia y botón
  • 14.3 Grupo
  • 14.4 Spoiler
  • 14.5 Encuesta
• 15 A tener en cuenta
  • 15.1 Párrafos y líneas en blanco
  • 15.2 Escapado de caracteres especiales
  • 15.3 Atajos de teclado

Formatos de letra

Flanqueando un texto con los siguientes carácteres puedes dar formato a la letra:

• Utiliza el guión bajo para hacer la letra _cursiva_.
• Utiliza el asterisco poner en *negrita* un texto quieras destacar.
• Utiliza la virgulilla para ~tachar~ una porción de texto borrada o errónea.
• Utiliza el acento grave para hacer la `letra monoespaciada` e indicar que un texto es un comando.
• Utiliza el signo más para +subrayar+ una parte importante.
• Utiliza el signo igual para =marcar= como si se tratase de un marcador fluorescente.

Enlaces

Puedes crear un enlace simplemente escribiendo la URL, que el sistema se encargará de acortar y enlazar. En algunos casos tendrás que rodear la URL con los signos menor que < y mayor que > para aislarla de los caracteres que están justo antes o después y que no se incluyan por error en el enlace, como <https://url>. También deberás hacerlo si la URL es relativa.

Puedes indicar el texto del enlace que apuntará a la URL con el siguiente formato: <Texto del enlace https://dominio.com>.

<Enlace a *Google* https://google.es>

Menciones de usuarios

Si quieres citar a otro usuario para que el sistema le avise, escribe una arroba @ y a continuación su nombre de usuario, como en @josh. Si el nombre de usuario contiene espacios o guión -, deberás cerrar el nombre con otra arroba, como en @juan antonio@.

Imágenes

Para insertar una imagen utiliza el siguiente formato: ![Texto alternativo https://bandaancha.eu/imagen.gif altoxancho].

Aunque el texto alternativo puede estar vacío, es recomendable rellenarlo ya que facilita la accesibilidad de los invidentes si describe el contenido la imágen.

Para centrar una imagen debes situarla en una nueva línea como único elemento. En este caso si escribes un texto en la línea inmediatamente debajo se convertirá en el pie de foto.

![Texto alternativo https://i.imgur.com/oRBqBap.png 300x100]
Texto pie de foto

⬇

identificador: ![Texto alternativo https://i.imgur.com/oRBqBap.png]

![identificador]

Vídeos

Puedes insertar vídeos alojados en YouTube situándolo en una nueva línea como único elemento.

%[https://www.youtube.com/watch?v=qXFBXSPk6JI]

Si sueles utilizar otro servicio de alojamiento de vídeos y te gustaría que lo soportemos puedes pedírnoslo y valoraremos añadirlo.

Encabezados

Escribe entre una # y seís almohadillas ###### consecutivas al principio de la línea que quieres convertir en un título de sección. El número de almohadillas indica el nivel de la sección, siendo el 1 el más importante.

## Título secundario de sección

Listas

Para crear una lista de elementos, simplemente inicia la línea con un guión -. Si quieres que sea numerada, iniciala con un número seguido de un punto ..

- Primer elemento de la lista no numerada
  1. Primer elemento de la sublista numerada
  2. Segundo elemento

Las listas se pueden anidar situando las sublistas más a la derecha que su lista padre.

En las listas numeradas no importa el orden de los números puesto que el sistema se encargará de mostrarlos correlativos.

Citas

Para mostrar un párrafo como texto citado precede la línea con un signo mayor que >.

> Esto es un texto citado.
> Formado por varios párrafos.

Si la cita está compuesta por varias líneas consecutivas como en nuestro ejemplo, estas se agruparán en un solo bloque. Para mostrar bloques independientes, separa los párrafos por líneas en blanco.

Tablas

Puedes crear una tabla simplemente separando el contenido de las columnas con una barra vertical |.

Celda A1 | Celda A2
Celda B1 | Celda B2

Columna 1   ¦ Columna 2     | Columna 3
! Columna 1 y 2             |"
-           ¦ ><            | >
única línea ¦ primera línea | ¶
            ¦ segunda línea | segunda línea ¶
            ¦ tercera línea |
uno         ¦ dos           | tres
"           ¦ 2             |

Bloques de código

Puedes crear un bloque de texto en letra monoespaciada flanqueándolo con dos líneas con uno o más caracteres contiguos de acento grave `.

` ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
`

require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html

Junto a los acentos de apertura puedes indicar opcionalmente el nombre del lenguaje de programación con el que está escrito el código que aparece dentro del bloque. Puede que se utilice para colorear la sintaxis.

Barra horizontal

Puedes separar dos partes independientes de tu mensaje con una barra horizontal, escribiendo en una línea tres o más guiones consecutivos. No puedes poner más de una barra horizontal seguida ni al principio o final de un mensaje.

---

Pie de foto

Puedes añadir un texto explicativo bajo algunos elementos, como imágenes, vídeos, citas, tablas o bloques de código. Escribe en la línea inmediatamente inferior el texto que se mostrará como pie.

> Ser o no ser
Fragmento conocido de la obra Hamlet de William Shakespeare

Elementos especiales

Puedes utilizar algunos elementos especiales situándolos en solitario en una nueva línea.

$[break]
En los artículos de portada, marca el fin de la introducción de un mensaje que aparece en la vista resumida.

Tabla de contenidos

$[toc]
Colócalo al principio de tu mensaje para generar una tabla de contenidos con enlaces a cada uno de los encabezados, como la que aparece al principio de este artículo.

Consejo, advertencia y botón

Los siguientes afectan a la línea de texto que tienen inmediatamente debajo:

$[tip]
Muestra un icono de consejo o sugerencia junto al texto

$[warning]
Muestra un icono de advertencia junto al texto

$[button]
Coloca el texto dentro de un botón que al pulsar abrirá la URL del <primer enlace https://google.es> del texto

Grupo

Puedes agrupar una serie de elementos relacionados en un grupo que se mostrará con un color de fondo diferente al del resto del mensaje.

$[group]
Conjunto de párrafos.

En un mismo grupo.
[group]$

⬇

Spoiler

Puedes ocultar una parte de tu mensaje y dejar que el lector decida si quiere leerla al pulsar sobre ella. Rodea la parte que quieras ocultar con sendas líneas que solo contengan $[spoiler].

$[spoiler]
La primera línea invita al usuario a abrir el _spoiler_.
El resto de elementos están ocultos y se muestran al hacer `click`.
[spoiler]$

Encuesta

Esta función está en desarrollo y es probable que no funcione

Puedes crear una encuesta de opinión y permitir que los lectores voten su opción favorita hasta un máximo de seis.

$[poll]
La primera línea contiene la cuestión por la que se pregunta
Las siguientes líneas
Contienen las opciones
Disponibles para votar

A tener en cuenta

Párrafos y líneas en blanco

Cada nueva línea representa un nuevo párrafo. Puedes opcionalmente separar los párrafos con una línea en blanco si te resulta más cómodo, aunque esto no influye en el aspecto final.

Si quieres que la siguiente línea aparezca en el mismo párrafo, finaliza la línea actual con un signo de calderón ¶. Puedes utilizarlo en párrafos, pies de foto, listas, citas y filas de tabla.

Escapado de caracteres especiales

Si deseas que un carácter especial se muestre tal y como es sin que se interprete como formato debes precederlo por una barra invertida \. Por ejemplo, para mostrar el asterisco * sin que se interprete como que la letra debe ser negrita escribe \*.

Dentro de un texto marcado como código no es necesario escapar los carácteres especiales, puesto que no se interpretan.

Atajos de teclado

En ordenadores personales es necesario utilizar las siguiente combinaciones de teclas para crear algunos caracteres especiales.