Markdown es un lenguaje de marcado ligero que te permite formatear fácilmente el texto sin la necesidad de utilizar complicadas etiquetas de HTML. Es ampliamente utilizado en plataformas como GitHub, Writefreely, Mataroa.blog y Joplin para escribir documentos, publicaciones, notas y comentarios con formato enriquecido.

Nada te impedirá utilizar este lenguaje para tomar notas y apuntes de tus clases o reuniones en una determinada aplicación. Incluso podrías escribir un libro con él, ya que puedes exportar fácilmente el resultado final a un formato ePub.

Ahora, con este mini tutorial, podrás acercarte al mundo de Markdown y aprovechar al máximo sus ventajas para escribir de manera efectiva y elegante en cualquier contexto, ya sea online u offline. ¡Comencemos!

Encabezados

Los encabezados en Markdown se utilizan para estructurar el contenido. Puedes crear encabezados colocando uno o varios símbolos de numeral (#) al comienzo de una línea. El número de símbolos determina el nivel de encabezado, desde H1 hasta H6. Ejemplo:

#Encabezado de nivel 1

##Encabezado de nivel 2

###Encabezado de nivel 3

Estilos de texto

Puedes aplicar estilos a tu texto en Markdown de la siguiente manera:

• Cursiva : Encierra el texto entre asteriscos (*).
• Negrita : Encierra el texto entre dos asteriscos (**).
• Cursiva y negrita : Encierra el texto entre tres asteriscos (***). Ejemplo:
  • Texto en cursiva
  • Texto en negrita
  • ** Texto en cursiva y negrita**

Listas

Markdown admite dos tipos de listas: listas ordenadas y listas sin ordenar.

Listas ordenadas se crean colocando números seguidos de un punto. Ejemplo de lista ordenada:

1. Primer elemento

2. Segundo elemento

3. Tercer elemento

Listas sin ordenar se crean utilizando guiones, asteriscos o signos de más. Ejemplo de lista sin orden:

– Elemento uno

– Elemento dos

– Elemento tres

Enlaces

Puedes crear enlaces en Markdown utilizando la siguiente sintaxis:

[Texto del enlace] (URL del enlace) «quitar espacios»

Imágenes

Para insertar imágenes en Markdown , utiliza la siguiente sintaxis:

![Texto alternativo] (URL de la imagen) «quitar espacios»

Citas

Puedes crear citas en Markdown utilizando el símbolo mayor que (>). Ejemplo:

Esto es una cita.

Código

Para resaltar código en línea, enciérralo entre comillas graves ( `). Ejemplo:

print("Hola, mundo!")

def saludar(): print("Hola, mundo!")

Tablas

Para crear tablas en Markdown , puedes utilizar guiones y barras verticales para definir la estructura de la tabla.

Aquí tienes un ejemplo de cómo crear una tabla básica con dos columnas:

| Encabezado de la columna 1 | Encabezado de la columna 2 |

|——————————-|—————-—————|

| Celda 1,1 | Celda 1,2 |

| Celda 2,1 | Celda 2,2 |

En la primera línea, se definen los encabezados de las columnas utilizando barras verticales para separar cada uno. Luego, en la segunda línea, se utiliza una serie de guiones para indicar el inicio de las celdas. A continuación, en las líneas siguientes, se agregan los contenidos de las celdas, separados por barras verticales.

Puedes agregar tantas filas como desees, simplemente añadiendo nuevas líneas con el mismo formato. También puedes ajustar la alineación del texto en las celdas utilizando dos puntos (:). Por ejemplo, |:—|—:| alinea el texto a la izquierda en la primera columna y a la derecha en la segunda columna.

Aquí tienes un ejemplo con alineación de texto:

Item	Precio
Producto 1	$10
Producto 2	$20

Ahora que has adquirido los conocimientos básicos para escribir en Markdown , estás preparado/a para utilizar este lenguaje sencillo y rápido de formato en tus textos. Markdown es ampliamente utilizado tanto en blogs como Writefreely, como en aplicaciones de notas populares como Joplin.

¡Disfruta de la experiencia de escribir en Markdown y dale vida a tus textos con formato enriquecido!

¡Diviértete explorando todas las posibilidades que ofrece Markdown!

#Tecnología #Markdown #Tutorial

Hoy os traigo un emocionante proyecto: montar tu propia instancia de WriteFreely , lo que te permitirá tener tu blog minimalista. En este artículo, describiré los pasos que he seguido para crear mi propio blog en una instancia de WriteFreely.

Paso 1: Preparativos

Lo primero que debes hacer es crear un usuario llamado «writefreely». A continuación, ingresa a este usuario utilizando los siguientes comandos:

useradd -r -m -d /srv/writefreely -s /bin/bash writefreely usermod -a -G www-data writefreely su - writefreely

Paso 2: Descargar WriteFreely

Descarga la última versión de WriteFreely desde GitHub y descomprímelo. Asegúrate de reemplazar «dominio.com» con tu propio dominio.

wget https://github.com/writefreely/writefreely/releases/download/v0.13.2/writefreely_0.13.2_linux_amd64.tar.gz

tar xvzf writefreely_0.13.2_linux_amd64.tar.gz

mv writefreely dominio.com

exit

chown writefreely.www-data -R /srv/writefreely/

Paso 3: Configura la Base de Datos

Instala MariaDB y crea una base de datos. Sustituye «usuarioqueelijas» y «contraseñaqueelijas» por los valores que prefieras.

apt install mariadb-server

mysql -u root -p

CREATE DATABASE writefreely;

GRANT ALL PRIVILEGES ON writefreely.* TO 'usuarioqueelijas'@'localhost' IDENTIFIED BY 'contraseñaqueelijas';

exit

Paso 4: Genera la Configuración de WriteFreely

Accede al usuario «writefreely» y crea la configuración de WriteFreely. Asegúrate de reemplazar «dominio.com», «usuarioqueelijas», «contraseñaqueelijas» y otros valores según tus preferencias.

su - writefreely

cd dominio.com./writefreely --create-config

Modifica el archivo de configuración con los siguientes datos:

username = usuarioqueelijas

password = contraseñaqueelijas

database = writefreely

site_name          = WriteFreely de usuario

site_description   = Tutorial de como instalar WriteFreely

host               = https://nuestrodominio

default_visibility = unlisted

Una vez hecho, guarda el archivo.

Paso 5: Genera la Clave de Cifrado y el Usuario Administrador

Desde el usuario «writefreely,» genera la clave de cifrado y crea el usuario administrador.

    ./writefreely db init

    ./writefreely keys generate

    ./writefreely --create-admin usuarioqueelijas:contraseñaqueelijas

Paso 6: Crea el Servicio en Systemd

Sal del usuario «writefreely» y crea un servicio Systemd.

nano /etc/systemd/system/writefreely.service

Pega el siguiente contenido en el archivo:

[Unit]
Description=WriteFreely Instance
After=syslog.target network.target mysql.service

[Service]
Type=simple
StandardOutput=syslog
StandardError=syslog
User=writefreely
Group=writefreely
WorkingDirectory=/srv/writefreely/nuestrodominio.com
ExecStart=/srv/writefreely/nuestrodominio.com/writefreely
Restart=always

[Install]
WantedBy=multi-user.target

Guarda el archivo y ejecuta los siguientes comandos:

systemctl daemon-reload
systemctl start writefreely
systemctl enable writefreely

Paso 7: Configura Nginx

Instala Nginx y Certbot , luego crea el archivo de configuración de Nginx.

apt install nginx certbot python3-certbot-nginx nano /etc/nginx/sites-available/writefreely.conf

En el archivo de configuración, agrega la siguiente configuración. Asegúrate de reemplazar «dominio.com» con tu propio dominio:

server {
    listen 80;
    listen [::]:80;

    server_name nuestrodominio.com;

    gzip on;
    gzip_types
      application/javascript
      application/x-javascript
      application/json
      application/rss+xml
      application/xml
      image/svg+xml
      image/x-icon
      application/vnd.ms-fontobject
      application/font-sfnt
      text/css
      text/plain;
    gzip_min_length 256;
    gzip_comp_level 5;
    gzip_http_version 1.1;
    gzip_vary on;

    location ~ ^/.well-known/(webfinger|nodeinfo|host-meta) {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_pass http://127.0.0.1:8080;
        proxy_redirect off;
    }

    location ~ ^/(css|img|js|fonts)/ {
        root /srv/writefreely/nuestrodominio.com/static;
        # Optionally cache these files in the browser:
        # expires 12M;
    }

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_pass http://127.0.0.1:8080;
        proxy_redirect off;
    }
}

Guarda el archivo y habilita el sitio:

cd /etc/nginx/sites-enabled/
ln -s ../sites-available/writefreely.conf
nginx -t
systemctl reload nginx

Paso 8: Configura Certbot

Finalmente, configura Certbot para obtener un certificado SSL.

    
apt install -y 
certbot python3-certbot-nginx
certbot

Sigue las instrucciones de Certbot para obtener un certificado SSL.

¡Listo! Ahora puedes acceder a tu blog ingresando tu dominio en el navegador y utilizar el

usuario y la contraseña que configuraste anteriormente. Si encuentras algún error o necesitas ayuda, no dudes en contactarme en Mastodon.

¡Espero que disfrutes de tu nuevo blog minimalista creado con WriteFreely!

#Tecnología #Writefreely #Tutorial

¿Te gustaría agregar la función de traducción a tu instancia de Mastodon? Mastodon es una red social descentralizada y de código abierto que permite una mayor personalización. Una de las características útiles es la capacidad de traducir mensajes en otros idiomas sin tener que salir de la plataforma. Sigue estos sencillos pasos para habilitar el botón de traducción:

Nota: Para realizar estos pasos, debes ser el administrador de tu instancia y tener acceso a la terminal donde tienes instalado Mastodon.

Paso 1: Crea una Cuenta en Deepl

Deepl es un servicio de traducción automática en línea que puedes utilizar en tu instancia de Mastodon. Necesitarás una cuenta en Deepl, que ofrece tanto una opción gratuita como de pago. La cuenta gratuita te permite traducir hasta 500,000 caracteres al mes, lo cual es suficiente para una instancia pequeña o personal. Si administras una instancia grande con mucha actividad, es posible que desees considerar una opción de pago para cubrir tus necesidades de traducción.

Existen otros servicios de traducción automática en línea, como Google Translate o Microsoft Translator, que también puedes evaluar. Compara las opciones disponibles y elige la que mejor se adapte a tus necesidades.

Paso 2: Obtiene tu Clave API de Deepl

Una vez que tengas tu cuenta gratuita en Deepl, obtendrás una clave API. Esta clave es un código necesario para conectar Deepl con tu instancia de Mastodon y permitir la traducción de mensajes. Asegúrate de guardar esta clave en un lugar seguro, ya que la necesitarás más adelante para configurar la integración con Mastodon.

Paso 3: Modifica el Archivo .env.production

A continuación, accede a la terminal donde tienes instalada la instancia de Mastodon. Debes modificar el archivo .env.production. Sigue estos pasos:

su - mastodoncd livenano .env.production

Ahora, añade las siguientes líneas al final del archivo, reemplazando "CLAVE API" por tu clave API de Deepl sin comillas, tal como te la proporcionaron:

DEEPL_API_KEY="CLAVE API"DEEPL_PLAN=free

Guarda los cambios y sal del editor de texto.

Paso 4: Reinicia Mastodon

Vuelve al usuario root y reinicia Mastodon para aplicar los cambios:

$ systemctl restart mastodon-sidekiq$ systemctl reload mastodon-web

¡Y eso es todo! Ahora tendrás el botón de traducción en tu instancia de Mastodon para que los usuarios puedan traducir mensajes de otros idiomas fácilmente.

¿Qué te ha parecido esta configuración? ¿No te parece fácil y útil? ¡Esperamos que disfrutes de esta nueva funcionalidad en tu instancia de Mastodon!

#Tecnología #Mastodon #Tutorial