Markdown

 

Markdown: Cómo escribir contenido técnico de forma profesional (y por qué empiezo a usarlo)

Hola 👋
En esta publicación quiero contarte qué es Markdown, por qué empecé a usarlo para escribir artículos técnicos, y cómo lo podés aplicar vos también si te gusta documentar lo que aprendés, como yo.

🧠 ¿Qué es Markdown?

Markdown es un lenguaje de marcado liviano, creado para escribir texto que se vea bien tanto en su forma simple como en formato web. Se usa mucho en la programación, documentación técnica, blogs de desarrollo, y más.

Con Markdown, podés darle formato al texto usando símbolos simples. No necesitás botones, ni editores pesados. Solo texto plano... ¡pero con poder!

✍️ Ejemplos de sintaxis Markdown

Acá te muestro los formatos más comunes para que empieces a practicar:

✍️ Reglas básicas de Markdown que tenés que saber:

FormatoSintaxis MarkdownEjemplo en texto
Título (nivel 1-6)#, ##, ###, etc.## Título secundario
Negrita**texto** o __texto__**importante** → importante
Cursiva*texto* o _texto_*palabra* → palabra
Lista desordenada- o * seguido del ítem- Item 1
- Item 2
Lista ordenada1., 2., etc.1. Paso uno
2. Paso dos
Enlace[texto](https://url.com)[Google](https://google.com)
Imagen![alt](url)![logo](https://logo.png)
Código en línea`codigo``echo "Hola"`
Bloque de códigoTriple tilde o triple backtick ```````bash\nsudo apt install php\n
Cita o blockquote> al inicio de línea> Esto es una cita
Separador horizontal--- o ***---

🚀 ¿Por qué empiezo a usar Markdown?

Porque me permite escribir artículos técnicos de forma clara, ordenada y portable. Puedo trabajar los contenidos en cualquier editor de texto, como VS Code, y luego llevarlos a plataformas que soporten .md, como GitHub o Dev.to.

🛠️ ¿Y qué pasa con Blogger?

Voy a seguir usando este espacio como diario de aprendizaje, especialmente para contenidos introductorios, reflexiones, o tutoriales simples.

Pero los informes más técnicos, trabajos más largos o artículos que incluyan fragmentos de código... los vas a encontrar desde ahora en:

👉 Mi blog técnico en Dev.to

🧭 Cómo me estoy organizando entre Blogger y Dev.to

Desde que empecé a escribir sobre lo que aprendo, me di cuenta de que necesitaba dos espacios distintos para expresarme bien. Por eso decidí usar este blog (Blogger) como mi diario personal de desarrollo, y al mismo tiempo empezar a publicar artículos más técnicos en Dev.to.

Te explico cómo los voy a usar y qué vas a encontrar en cada uno:

📰 Blogger → Diario de bitácora, informal, reflexivo, personal

Este blog sigue siendo mi lugar de todos los días. Acá escribo de forma libre, descontracturada, y como me salga. 😄

¿Qué vas a encontrar acá?

  • Cosas que aprendí “al paso”.

  • Reflexiones sin tanto filtro (sí, a veces puteando).

  • Errores del día, soluciones rápidas, frustraciones.

  • Opiniones, ideas locas, cosas que quiero recordar.

  • Enlaces a artículos más completos en Dev.to.

Estilo: relajado, natural, con emojis, sin presión.

Ejemplos de títulos que podría publicar acá:

👉 “Hoy rompí Composer y aprendí algo sobre dependencias”
👉 “Cómo me arreglé con Apache después de 3 cafés ☕”

🧑‍💻 Dev.to → Publicaciones técnicas, con Markdown

Para cosas más formales y estructuradas, empecé a usar Dev.to, que me permite escribir en Markdown, incluir código fácilmente, y publicar artículos más técnicos.

¿Qué vas a encontrar allá?

  • Artículos bien explicados, con ejemplos de código.

  • Tutoriales paso a paso.

  • Casos de estudio reales (cosas que resolví).

  • Informes técnicos.

  • Diagramas, esquemas, explicaciones profundas.

  • Cosas que podrían ayudar a otros devs.

Estilo: técnico, claro, profesional (pero sin dejar de ser yo).

Ejemplos de títulos que voy a subir a Dev.to:

👉 “Cómo configurar Apache en Xubuntu para desarrollo local”
👉 “Diagramas UML para un proyecto Symfony eCommerce: caso ShopLite”

¿Por qué hago esto?

Porque quiero separar lo técnico de lo personal, sin dejar de escribir.
Porque quiero un lugar para pensar y otro para enseñar.
Y porque quiero que vos, que estás leyendo esto, puedas elegir si preferís el lado informal o el lado profesional de mi contenido.

Ambos son parte del mismo camino: seguir aprendiendo y dejar huella.

Nos seguimos leyendo por acá o por allá 👋
👉 Visitar mi perfil en Dev.to

¡Seguimos aprendiendo y compartiendo! 💻🧠

Comentarios

Publicar un comentario

Entradas populares de este blog

phpMyAdmin

  Instalación y configuración de phpMyAdmin en Xubuntu 24.04 con Apache personalizado Introducción En esta guía detallo cómo instalé y configuré phpMyAdmin en un entorno con Apache 2 , PHP 8.2 y MariaDB en Xubuntu 24.04 , utilizando un directorio personalizado para el servidor web. También explico cómo resolver problemas comunes derivados de cambiar la raíz de Apache y cómo mantener todo funcionando correctamente en futuras configuraciones. Requisitos previos Tener Apache2, PHP 8.2 y MariaDB instalados y funcionando. Haber cambiado la carpeta raíz de Apache a una ruta personalizada, en mi caso: /home/anthony/server/php/ Instalación de phpMyAdmin y módulos necesarios Ejecuté el siguiente comando para instalar phpMyAdmin y los módulos de PHP requeridos: sudo apt install phpmyadmin php-mbstring php-zip php-gd php-json php-curl Esto instala: phpmyadmin : interfaz web para administrar bases de datos. php-mbstring : soporte para cadenas multibyte (requerido por phpM...
Leer más

Instalación de PHP 8.2

  🐘 Instalación de PHP 8.2 en Xubuntu 24.04 con Apache2 para Laravel y Symfony En este artículo te comparto el proceso completo y documentado de cómo instalé PHP 8.2 en Xubuntu 24.04, con Apache2, listo para desarrollar con Laravel y Symfony . Además, explico dónde se instala PHP, qué módulos usé y por qué. 📦 1. Requisitos previos Ya tenía instalado Apache2 , así que empecé por agregar los repositorios actualizados y confiables para obtener versiones más recientes de PHP. sudo apt install software-properties-common sudo add-apt-repository ppa:ondrej/php sudo add-apt-repository ppa:ondrej/apache2 sudo apt update El PPA de Ondrej Sury es uno de los más utilizados y confiables para PHP en Ubuntu.   🧩 2. Instalación completa de PHP 8.2 y sus módulos necesarios Una sola línea para instalar todo lo que necesitás para trabajar con Symfony y Laravel: sudo apt install php8.2 libapache2-mod-php8.2 php8.2-cli php8.2-common php8.2-mysql php8.2-pgsql php8.2-sqlite3 php8.2-xml php8....
Leer más

Terminal Caliente

  ☕ Domingo frío, terminal caliente Hoy fue uno de esos días en los que el frío invita a quedarse en casa, con una buena taza de chocolate (o té, no juzgo 😄) y un fondo de música tranquila. Pero lejos de quedarme tirado mirando series, decidí seguir poniéndole onda a mi netbook, que viene bancándose toda la instalación de herramientas para desarrollo como una campeona 💻🔥 Hace poquito instalé Xubuntu 24.04 , y a esta altura ya teníamos en marcha: ✅ Python ✅ MariaDB ✅ Apache2 ✅ phpMyAdmin ✅ ¡Y hasta un proyecto en Symfony corriendo! Pero claro, la idea es dejar la máquina lista para todo terreno , así que hoy me puse con dos grandes: Python y Java 🐍☕. 🐍 Python: ya viene en Linux, pero lo afinamos Linux ya trae Python, pero le faltaba su fiel compañero pip , así que lo instalé y dejé todo listo para empezar a trabajar con Django. 💡 De paso, documenté la instalación en Dev.to, por si le sirve a alguien más: 👉 pip en Xubuntu ☕ Java: OpenJDK al rescate Tambié...
Leer más