DEV Community

Francisco Escobar
Francisco Escobar

Posted on

📝 Guía de Escritura en Markdown para dev.to

#beginners #devto #aws #community

Una guia exhaustiva para crear articulos tecnicos de alta calidad en dev.to, optimizada para contenido AWS y certificaciones cloud.

🗺️ Tabla de contenidos

📋 Front Matter (Metadatos del post)

El front matter va al inicio del archivo, entre ---. Controla como se muestra tu post en dev.to.

Sintaxis basica 

---
title: Tu titulo aqui (max 128 caracteres)
published: false
description: Descripcion corta para SEO (max 156 caracteres)
tags: aws, cloud, devops, tutorial
cover_image: https://url-de-tu-imagen.jpg
canonical_url: https://tu-blog.com/post-original
series: Nombre de la serie
---
Enter fullscreen mode Exit fullscreen mode

Campos explicados

Campo Requerido Descripcion Limites
title ✅ Titulo del post (aparece en el feed) Max 128 caracteres
published ✅ true = publico, false = borrador -
description ⚠️ Meta description para SEO y preview Max 156 caracteres
tags ⚠️ Categorias del post Max 4 tags, separados por coma
cover_image ❌ URL de imagen de portada 1000x420 px ideal
canonical_url ❌ Si publicaste primero en otro sitio URL completa
series ❌ Agrupa posts relacionados Texto libre

Tags populares para contenido AWS 

# Tutoriales generales
tags: aws, cloud, devops, tutorial

# Seguridad y networking
tags: aws, security, networking, beginners

# Serverless
tags: aws, serverless, lambda, architecture

# Certificaciones
tags: aws, certification, career, learning

# Infrastructure as Code
tags: aws, terraform, cloudformation, iac

# Containers
tags: aws, docker, kubernetes, ecs

# Machine Learning
tags: aws, machinelearning, bedrock, ai
Enter fullscreen mode Exit fullscreen mode

Ejemplos de titulos efectivos 

# ❌ Titulos genericos (evitar)
title: Aprendiendo AWS
title: Tutorial de VPC
title: Mi experiencia con Lambda

# ✅ Titulos especificos y atractivos
title: "VPC en AWS: Guia Practica con Diagrama y Codigo [2025]"
title: "Security Groups vs NACLs: La Guia Definitiva para el SAA-C03"
title: "Como Reduje el Costo de Lambda en 70% con estas 5 Tecnicas"
title: "De Cero a Arquitecto AWS: Mi Ruta de 6 Meses al SAA-C03"
Enter fullscreen mode Exit fullscreen mode

Series para contenido relacionado 

# Post 1
---
title: "AWS VPC Masterclass - Parte 1: Fundamentos"
series: AWS VPC Masterclass
---

# Post 2
---
title: "AWS VPC Masterclass - Parte 2: Subnets y Routing"
series: AWS VPC Masterclass
---
Enter fullscreen mode Exit fullscreen mode

💡 Tip: Los posts de la misma serie se enlazan automaticamente en dev.to.

⬆️ Volver arriba

🏗️ Estructura de un articulo

Anatomia de un post efectivo 

┌─────────────────────────────────────────────────────────────────┐
│  HOOK (primeras 3 lineas)                                       │
│  - Captura atencion inmediata                                   │
│  - Problema que resuelve                                        │
│  - Beneficio para el lector                                     │
├─────────────────────────────────────────────────────────────────┤
│  TL;DR / RESUMEN EJECUTIVO                                      │
│  - Que aprenderan                                               │
│  - Tiempo estimado                                              │
│  - Nivel de dificultad                                          │
├─────────────────────────────────────────────────────────────────┤
│  METADATOS RAPIDOS (tabla)                                      │
│  - Servicios AWS usados                                         │
│  - Requisitos previos                                           │
│  - Costos estimados                                             │
├─────────────────────────────────────────────────────────────────┤
│  TABLA DE CONTENIDOS                                            │
│  - Enlaces a cada seccion                                       │
├─────────────────────────────────────────────────────────────────┤
│  CONTENIDO PRINCIPAL                                            │
│  - Por que importa (contexto)                                   │
│  - Arquitectura (diagrama)                                      │
│  - Paso a paso (tutorial)                                       │
│  - Validacion (verificar que funciona)                          │
├─────────────────────────────────────────────────────────────────┤
│  TROUBLESHOOTING                                                │
│  - Errores comunes                                              │
│  - Soluciones                                                   │
├─────────────────────────────────────────────────────────────────┤
│  CONCEPTOS PARA EL EXAMEN (si aplica)                           │
│  - Tips para certificacion                                      │
│  - Preguntas tipicas                                            │
├─────────────────────────────────────────────────────────────────┤
│  LIMPIEZA DE RECURSOS                                           │
│  - Comandos para eliminar                                       │
│  - Evitar costos inesperados                                    │
├─────────────────────────────────────────────────────────────────┤
│  RECURSOS Y REFERENCIAS                                         │
│  - Documentacion oficial                                        │
│  - Posts relacionados                                           │
├─────────────────────────────────────────────────────────────────┤
│  CALL TO ACTION                                                 │
│  - Seguir para mas contenido                                    │
│  - Comentarios/feedback                                         │
│  - Repositorio de codigo                                        │
└─────────────────────────────────────────────────────────────────┘
Enter fullscreen mode Exit fullscreen mode

⬆️ Volver arriba

✍️ Formato de texto basico

Sintaxis de formato

Elemento Sintaxis Resultado
Negrita **texto** texto
Cursiva *texto* texto
Negrita + cursiva ***texto*** texto
Tachado ~~texto~~ tachado
Codigo inline `codigo` codigo
Resaltado <mark>texto</mark> texto
Subindice H<sub>2</sub>O H2O
Superindice X<sup>2</sup> X2

Combinaciones utiles para documentacion tecnica 

**⚠️ Importante:** Este paso es critico para la seguridad.

> 💡 **Tip**: Usa `aws configure --profile dev` para multiples perfiles.

`aws s3 ls` → **Lista todos los buckets** en tu cuenta.

La variable `${AWS_REGION}` debe estar configurada **antes** de ejecutar.

~~No uses root~~ → Usa un usuario IAM con MFA.
Enter fullscreen mode Exit fullscreen mode

Escapar caracteres especiales 

\*texto sin cursiva\*
\`codigo sin formato\`
\# no es un heading
Enter fullscreen mode Exit fullscreen mode

⬆️ Volver arriba

📑 Encabezados

Jerarquia correcta 

# H1 - Titulo del post (SOLO UNO por articulo)
## H2 - Secciones principales
### H3 - Subsecciones
#### H4 - Detalles especificos (usar con moderacion)
##### H5 - Evitar (demasiado profundo)
Enter fullscreen mode Exit fullscreen mode

Convencion con emojis 

## 💡 ¿Por qué importa?
## 🏗️ Arquitectura
## 📋 Prerrequisitos
## 🛠️ Paso a paso
## ✅ Validación
## 🔧 Troubleshooting
## 🎯 Conceptos para el examen
## 🧹 Limpieza
## 📚 Recursos
## 🏁 Conclusión
Enter fullscreen mode Exit fullscreen mode

⬆️ Volver arriba

📋 Listas

Lista con vinetas 

- Elemento nivel 1
- Otro elemento nivel 1
  - Sub-elemento nivel 2 (2 espacios)
  - Otro sub-elemento
    - Nivel 3 (4 espacios)
- De vuelta a nivel 1
Enter fullscreen mode Exit fullscreen mode

Lista numerada 

1. Primer paso
2. Segundo paso
3. Tercer paso
   1. Sub-paso A (3 espacios)
   2. Sub-paso B
4. Cuarto paso
Enter fullscreen mode Exit fullscreen mode

Lista de tareas (checkboxes) 

## Checklist de seguridad AWS

- [x] MFA habilitado en cuenta root
- [x] Usuario IAM creado (no usar root)
- [ ] CloudTrail habilitado
- [ ] AWS Config configurado
- [ ] GuardDuty activado
Enter fullscreen mode Exit fullscreen mode

Lista de definiciones 

**VPC (Virtual Private Cloud)**
: Red virtual aislada donde lanzas recursos AWS.

**Subnet**
: Segmento de una VPC con su propio rango CIDR.

**Internet Gateway (IGW)**
: Componente que permite comunicacion entre VPC e Internet.
Enter fullscreen mode Exit fullscreen mode

⬆️ Volver arriba

📊 Tablas

Sintaxis basica 

| Columna 1 | Columna 2 | Columna 3 |
|-----------|-----------|-----------|
| Dato 1    | Dato 2    | Dato 3    |
| Dato 4    | Dato 5    | Dato 6    |
Enter fullscreen mode Exit fullscreen mode

Alineacion de columnas 

| Izquierda | Centro | Derecha |
|:----------|:------:|--------:|
| texto     | texto  |   texto |
| mas       |  mas   |     mas |
Enter fullscreen mode Exit fullscreen mode

Tablas utiles para documentacion AWS

Comparacion de servicios:

## Security Groups vs NACLs

| Aspecto | Security Groups | NACLs |
|---------|:---------------:|:-----:|
| **Nivel** | Instancia (ENI) | Subnet |
| **Estado** | Stateful | Stateless |
| **Reglas** | Solo Allow | Allow y Deny |
| **Evaluacion** | Todas las reglas | Por numero (orden) |
| **Default** | Deny todo inbound | Allow todo |
Enter fullscreen mode Exit fullscreen mode

Tabla de troubleshooting:

| Sintoma | Posible causa | Solucion |
|---------|---------------|----------|
| `Connection timeout` | Security Group | Agregar regla inbound |
| `Permission denied` | IAM Policy | Verificar permisos |
| `No route to host` | Route Table | Verificar rutas |
Enter fullscreen mode Exit fullscreen mode

Tabla de precios/costos:

| Servicio | Configuracion | Costo/mes | Free Tier |
|----------|---------------|----------:|:---------:|
| EC2 | t3.micro | $7.59 | ✅ 750 hrs |
| RDS | db.t3.micro | $12.41 | ✅ 750 hrs |
| S3 | 10 GB | $0.23 | ✅ 5 GB |
| NAT Gateway | 10 GB transfer | $35.00 | ❌ |
| **Total** | | **$55.23** | |
Enter fullscreen mode Exit fullscreen mode

⬆️ Volver arriba

💻 Bloques de codigo

Sintaxis con highlighting 

```

python
import boto3

def lambda_handler(event, context):
    s3 = boto3.client('s3')
    return {'statusCode': 200}


```
```

`

### Lenguajes soportados

| Lenguaje | Identificador | Uso comun en AWS |
|----------|---------------|------------------|
| Python | `python` | Lambda, Boto3, scripts |
| JavaScript | `javascript` o `js` | Lambda Node.js, CDK |
| TypeScript | `typescript` o `ts` | CDK, Lambda |
| Bash | `bash` o `shell` | AWS CLI, scripts |
| JSON | `json` | Policies, CloudFormation |
| YAML | `yaml` | CloudFormation, SAM |
| HCL | `hcl` o `terraform` | Terraform |

### Codigo con titulo (feature de dev.to)

`

```markdown
```

python title="lambda_function.py"
import json
import boto3

def lambda_handler(event, context):
    return {
        'statusCode': 200,
        'body': json.dumps('Hello from Lambda!')
    }


```
```

`

### Resaltar lineas especificas

`

```markdown
```

python {3,5-7}
import boto3

# Esta linea se resalta
s3 = boto3.client('s3')
# Estas lineas
# tambien se
# resaltan
response = s3.list_buckets()


```
```

`

### Diff para mostrar cambios

`

```markdown
```

diff
  resource "aws_instance" "web" {
-   instance_type = "t2.micro"
+   instance_type = "t3.medium"
  }


```
```

`

### Ejemplos de codigo para AWS

**AWS CLI:**

```bash
# Crear VPC con tags
aws ec2 create-vpc \
    --cidr-block 10.0.0.0/16 \
    --tag-specifications 'ResourceType=vpc,Tags=[{Key=Name,Value=MyVPC}]' \
    --query 'Vpc.VpcId' \
    --output text
```

**Python con Boto3:**

```python title="s3_operations.py"
import boto3
from botocore.exceptions import ClientError

def upload_file(file_name, bucket, object_name=None):
    """Sube un archivo a S3 con manejo de errores."""
    s3_client = boto3.client('s3')

    try:
        s3_client.upload_file(file_name, bucket, object_name or file_name)
        print(f"Archivo {file_name} subido exitosamente")
        return True
    except ClientError as e:
        print(f"Error: {e}")
        return False
```

**CloudFormation YAML:**

```yaml title="vpc-template.yaml"
AWSTemplateFormatVersion: '2010-09-09'
Description: VPC con subnets publicas y privadas

Resources:
  VPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: 10.0.0.0/16
      EnableDnsHostnames: true
      Tags:
        - Key: Name
          Value: !Sub ${Environment}-vpc
```

**Terraform:**

```hcl title="main.tf"
resource "aws_vpc" "main" {
  cidr_block           = "10.0.0.0/16"
  enable_dns_hostnames = true

  tags = {
    Name        = "${var.project}-vpc"
    Environment = var.environment
  }
}
```

**IAM Policy JSON:**

```json title="s3-read-policy.json"
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowS3Read",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::my-bucket",
        "arn:aws:s3:::my-bucket/*"
      ]
    }
  ]
}
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="imagenes"></a>
## 🖼️ Imagenes

### Sintaxis basica

```markdown
![Texto alternativo](https://url-de-imagen.jpg)
```

### Subir imagenes a dev.to

**Opcion 1: Drag and Drop**
- Arrastra la imagen directamente al editor

**Opcion 2: Boton de imagen**
- Usa el boton de imagen en la barra del editor

**Opcion 3: GitHub (recomendado para repos)**

```markdown
![Diagrama](https://raw.githubusercontent.com/usuario/repo/main/images/arquitectura.png)
```

### Imagen con tamano personalizado

```markdown
<img src="https://url.jpg" alt="descripcion" width="600">
```

### Imagen centrada

```markdown
<p align="center">
  <img src="https://url.jpg" alt="Arquitectura AWS" width="700">
</p>
```

### Imagen con caption

```markdown
<figure>
  <img src="arquitectura.png" alt="Diagrama de arquitectura">
  <figcaption><em>Figura 1: Arquitectura de tres capas</em></figcaption>
</figure>
```

### Recursos para imagenes AWS

| Recurso | URL | Uso |
|---------|-----|-----|
| AWS Architecture Icons | https://aws.amazon.com/architecture/icons/ | Iconos oficiales |
| Draw.io | https://app.diagrams.net/ | Diagramas AWS |
| Excalidraw | https://excalidraw.com/ | Diagramas sketch |
| Cloudcraft | https://www.cloudcraft.co/ | Diagramas 3D |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="enlaces"></a>
## 🔗 Enlaces

### Sintaxis basica

```markdown
[Texto visible](https://url.com)
```

### Abrir en nueva pestana

```markdown
<a href="https://docs.aws.amazon.com" target="_blank">Documentacion AWS</a>
```

### Enlaces con referencia (para posts largos)

```markdown
Consulta la [documentacion de EC2][ec2-docs] y revisa el [pricing][ec2-pricing].

<!-- Referencias al final del documento -->
[ec2-docs]: https://docs.aws.amazon.com/ec2/
[ec2-pricing]: https://aws.amazon.com/ec2/pricing/
```

### Enlaces internos (anclas)

```markdown
Salta a la [seccion de troubleshooting](#troubleshoot).
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="toc"></a>
## 🗺️ Tabla de Contenidos (ToC) - LA SOLUCION DEFINITIVA

### El problema con los IDs auto-generados

dev.to genera IDs automaticamente de los encabezados, pero:
- Los emojis causan problemas
- Los acentos pueden fallar
- Los signos de puntuacion se eliminan de forma inconsistente

### La solucion: Anclas HTML manuales

Usa `<a name="id"></a>` **antes** de cada encabezado. Asi controlas exactamente el ID.

### Ejemplo completo que SIEMPRE funciona

```markdown
## 🗺️ Tabla de contenidos

- [¿Por qué importa?](#why)
- [Arquitectura](#arch)
- [Prerrequisitos](#prereq)
- [Paso a paso](#steps)
- [Validación](#validation)
- [Troubleshooting](#troubleshoot)
- [Conceptos para el examen](#exam)
- [Limpieza](#cleanup)
- [Recursos](#resources)

---

<a name="why"></a>
## 💡 ¿Por qué importa?

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="arch"></a>
## 🏗️ Arquitectura

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="prereq"></a>
## ✅ Prerrequisitos

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="steps"></a>
## 🛠️ Paso a paso

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="validation"></a>
## 🔎 Validación

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="troubleshoot"></a>
## 🧯 Troubleshooting

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="exam"></a>
## 🎓 Conceptos para el examen SAA-C03

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="cleanup"></a>
## 🧹 Limpieza

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="resources"></a>
## 📚 Recursos

Contenido de la seccion...

[⬆️ Volver arriba](#tabla-de-contenidos)
```

### Reglas para IDs manuales

| Regla | Ejemplo bueno | Ejemplo malo |
|-------|---------------|--------------|
| Solo minusculas | `why` | `Why` |
| Solo letras y numeros | `step1` | `step-1` (guiones ok pero innecesarios) |
| Sin espacios | `prereq` | `pre req` |
| Corto y descriptivo | `arch` | `arquitectura-del-sistema` |
| Sin acentos | `validacion` | `validación` |

### IDs recomendados para secciones comunes

| Seccion | ID recomendado |
|---------|----------------|
| ¿Por qué importa? | `why` |
| Arquitectura | `arch` |
| Prerrequisitos | `prereq` |
| Paso a paso | `steps` |
| Validacion | `validation` |
| Troubleshooting | `troubleshoot` |
| Para el examen | `exam` |
| Limpieza | `cleanup` |
| Recursos | `resources` |
| Conclusion | `conclusion` |
| Costos | `costs` |
| Seguridad | `security` |
| Bonus | `bonus` |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="volver-arriba"></a>
## ⬆️ Enlace "Volver arriba"

### Metodo recomendado

Agrega un enlace al final de cada seccion que apunte a la tabla de contenidos:

```markdown
[⬆️ Volver arriba](#tabla-de-contenidos)
```

### Variantes

```markdown
[⬆️ Volver arriba](#tabla-de-contenidos)
[🔝 Ir al inicio](#tabla-de-contenidos)
[↑ Top](#tabla-de-contenidos)
```

### Alineado a la derecha

```markdown
<p align="right">
  <a href="#tabla-de-contenidos">⬆️ Volver arriba</a>
</p>
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="callouts"></a>
## 💬 Callouts y notas

### Blockquotes con emojis (patron recomendado)

```markdown
> 💡 **Tip**: Usa AWS CloudShell para ejecutar comandos sin configurar CLI.

> ⚠️ **Advertencia**: Esta operacion no se puede deshacer.

> ❌ **Error comun**: No olvides configurar la region antes de ejecutar.

> ✅ **Best practice**: Siempre usa el principio de least privilege.

> 📝 **Nota**: Este servicio solo esta disponible en regiones seleccionadas.

> 🔥 **Importante**: Nunca expongas credenciales en el codigo.

> 💰 **Costo**: Esta configuracion genera aproximadamente $50/mes.

> 🎯 **Para el examen**: Este concepto aparece frecuentemente en el SAA-C03.

> 🧹 **Limpieza**: Recuerda eliminar los recursos al terminar.
```

### Callout multilinea

```markdown
> **⚠️ Consideraciones de seguridad**
>
> Antes de implementar en produccion:
>
> 1. Habilita encryption at rest
> 2. Configura VPC Flow Logs
> 3. Implementa AWS Config rules
> 4. Revisa IAM policies
```

### Liquid tags de dev.to para notas

```markdown
{% note %}
Esta es una nota informativa con estilo especial de dev.to.
{% endnote %}

{% warning %}
Esta es una advertencia importante.
{% endwarning %}

{% danger %}
Cuidado! Esto puede causar problemas serios.
{% endanger %}
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="diagramas"></a>
## 📐 Diagramas ASCII

### Arquitectura de tres capas

```
┌─────────────────────────────────────────────────────────────────┐
│                         INTERNET                                 │
└─────────────────────────────┬───────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  Route 53 (DNS)                                                 │
└─────────────────────────────┬───────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  CloudFront (CDN)                                               │
└─────────────────────────────┬───────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│  VPC 10.0.0.0/16                                                │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  Public Subnets                                            │  │
│  │  ┌─────────────┐           ┌─────────────┐                │  │
│  │  │     ALB     │           │ NAT Gateway │                │  │
│  │  └──────┬──────┘           └─────────────┘                │  │
│  └─────────┼─────────────────────────────────────────────────┘  │
│            │                                                     │
│  ┌─────────┼─────────────────────────────────────────────────┐  │
│  │  Private Subnets (App Tier)                               │  │
│  │         ▼                                                  │  │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐       │  │
│  │  │   EC2 #1    │  │   EC2 #2    │  │   EC2 #3    │       │  │
│  │  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘       │  │
│  └─────────┼────────────────┼────────────────┼───────────────┘  │
│            └────────────────┼────────────────┘                   │
│                             ▼                                    │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  Private Subnets (Data Tier)                              │  │
│  │  ┌─────────────────────────────────────────────────────┐  │  │
│  │  │              RDS Multi-AZ                            │  │  │
│  │  └─────────────────────────────────────────────────────┘  │  │
│  └───────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘
```

### VPC con subnets

```
┌─────────────────────────────────────────────────────────────────┐
│  VPC: 10.0.0.0/16                                               │
│                                                                  │
│  ┌─────────────────────────┐  ┌─────────────────────────┐       │
│  │  AZ: us-east-1a         │  │  AZ: us-east-1b         │       │
│  │                         │  │                         │       │
│  │  ┌───────────────────┐  │  │  ┌───────────────────┐  │       │
│  │  │ Public Subnet     │  │  │  │ Public Subnet     │  │       │
│  │  │ 10.0.1.0/24       │  │  │  │ 10.0.2.0/24       │  │       │
│  │  │ ┌───┐ ┌───┐       │  │  │  │ ┌───┐             │  │       │
│  │  │ │NAT│ │BAS│       │  │  │  │ │ALB│             │  │       │
│  │  │ └───┘ └───┘       │  │  │  │ └───┘             │  │       │
│  │  └───────────────────┘  │  │  └───────────────────┘  │       │
│  │                         │  │                         │       │
│  │  ┌───────────────────┐  │  │  ┌───────────────────┐  │       │
│  │  │ Private Subnet    │  │  │  │ Private Subnet    │  │       │
│  │  │ 10.0.11.0/24      │  │  │  │ 10.0.12.0/24      │  │       │
│  │  │ ┌───┐ ┌───┐       │  │  │  │ ┌───┐ ┌───┐       │  │       │
│  │  │ │EC2│ │EC2│       │  │  │  │ │EC2│ │EC2│       │  │       │
│  │  │ └───┘ └───┘       │  │  │  │ └───┘ └───┘       │  │       │
│  │  └───────────────────┘  │  │  └───────────────────┘  │       │
│  └─────────────────────────┘  └─────────────────────────┘       │
│                                                                  │
│  [IGW]──────────────────────────────────────────────────────    │
└─────────────────────────────────────────────────────────────────┘
```

### Caracteres utiles para diagramas

| Caracter | Uso |
|----------|-----|
| `─` `│` | Lineas horizontales y verticales |
| `┌` `┐` `└` `┘` | Esquinas |
| `├` `┤` `┬` `┴` `┼` | Conectores |
| `▲` `▼` `◄` `►` | Flechas solidas |
| `→` `←` `↑` `↓` | Flechas simples |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="liquid-tags"></a>
## 🏷️ Liquid Tags (exclusivos de dev.to)

### Embed de repositorio GitHub

```markdown
{% github usuario/repositorio %}

{% github usuario/repositorio no-readme %}
```

### Embed de Gist

```markdown
{% gist https://gist.github.com/usuario/ID %}

{% gist a1b2c3d4e5f6 file=example.py %}
```

### Embed de video YouTube

```markdown
{% youtube dQw4w9WgXcQ %}
```

### Embed de Tweet

```markdown
{% twitter 1234567890123456789 %}
```

### Embed de CodePen

```markdown
{% codepen https://codepen.io/usuario/pen/ID %}
```

### Embed de otro post de dev.to

```markdown
{% link https://dev.to/usuario/titulo-del-post-abc1 %}
```

### Embed de perfil de dev.to

```markdown
{% user nombreusuario %}
```

### Embed de tag

```markdown
{% tag aws %}
```

### Collapsible/Acordeon

```markdown
{% details Haz clic para ver la respuesta %}

Aqui esta el contenido oculto.

Puede incluir:
- Listas
- **Formato**
- `codigo`

{% enddetails %}
```

### Bloques de nota/warning/danger

```markdown
{% note %}
Esta es una nota informativa.
{% endnote %}

{% warning %}
Esta es una advertencia importante.
{% endwarning %}

{% danger %}
Cuidado! Esto puede causar problemas.
{% endanger %}
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="emojis"></a>
## 😀 Emojis recomendados

### Para titulos de seccion

| Seccion | Emoji |
|---------|-------|
| Introduccion | 💡 |
| Arquitectura | 🏗️ |
| Requisitos | 📋 |
| Paso a paso | 🛠️ |
| Codigo | 💻 |
| Configuracion | ⚙️ |
| Seguridad | 🔒 |
| Networking | 🌐 |
| Base de datos | 🗄️ |
| Troubleshooting | 🔧 o 🧯 |
| Validacion | ✅ o 🔎 |
| Para el examen | 🎯 o 🎓 |
| Recursos | 📚 |
| Conclusion | 🏁 |
| Limpieza | 🧹 |
| Costos | 💰 o 💸 |
| Advertencia | ⚠️ |
| Importante | 🔥 |
| Bonus | 🎁 |

### Para uso inline

| Contexto | Emoji |
|----------|-------|
| Correcto | ✅ |
| Incorrecto | ❌ |
| Tip | 💡 |
| Advertencia | ⚠️ |
| AWS/Cloud | ☁️ |
| Seguridad | 🔐 |
| Performance | ⚡ |
| Dinero | 💰 |
| Tiempo | ⏱️ |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="template"></a>
## 📄 Template completo para tutoriales AWS

```markdown
---
title: "Titulo Descriptivo [2025]"
published: false
description: Descripcion SEO-friendly en menos de 156 caracteres.
tags: aws, cloud, tutorial, servicio
cover_image: https://url-imagen.jpg
series: Nombre de la Serie (opcional)
---

# Titulo del Articulo

Parrafo de apertura que captura atencion.

> **TL;DR**
> Resumen en 2-3 lineas.
> **Tiempo**: 30 min | **Nivel**: 200 (Intermedio)

---

## 🧭 Metadatos rapidos

| Campo | Valor |
|---|---|
| **Servicios AWS** | VPC, EC2, RDS |
| **Requisitos** | Cuenta AWS, AWS CLI |
| **Costos** | Free Tier elegible |

---

## 🗺️ Tabla de contenidos

- [¿Por qué importa?](#why)
- [Arquitectura](#arch)
- [Prerrequisitos](#prereq)
- [Paso a paso](#steps)
- [Validación](#validation)
- [Troubleshooting](#troubleshoot)
- [Para el examen](#exam)
- [Limpieza](#cleanup)
- [Recursos](#resources)

---

<a name="why"></a>
## 💡 ¿Por qué importa?

**El problema**: [Descripcion]

**La solucion**: [Que van a construir]

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="arch"></a>
## 🏗️ Arquitectura

[Diagrama ASCII o imagen]

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="prereq"></a>
## ✅ Prerrequisitos

- [ ] Cuenta de AWS activa
- [ ] AWS CLI v2 instalado

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="steps"></a>
## 🛠️ Paso a paso

### 1) Fase 1: Titulo

Explicacion...

```bash
aws ec2 create-vpc --cidr-block 10.0.0.0/16
```

> 💡 **Tip**: Informacion util.

### 2) Fase 2: Titulo

Explicacion...

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="validation"></a>
## 🔎 Validación

```bash
aws ec2 describe-vpcs --vpc-ids $VPC_ID
```

✅ **Exito**: Estado `available`

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="troubleshoot"></a>
## 🧯 Troubleshooting

| Sintoma | Causa | Solucion |
|---------|-------|----------|
| Timeout | Security Group | Verificar reglas |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="exam"></a>
## 🎓 Para el examen SAA-C03

1. **Punto clave 1**: Explicacion
2. **Punto clave 2**: Explicacion

> 📝 **Pregunta tipica**: "¿...?"

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="cleanup"></a>
## 🧹 Limpieza

**⚠️ Importante**: Elimina los recursos para evitar cargos.

```bash
aws ec2 delete-vpc --vpc-id $VPC_ID
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="resources"></a>
## 📚 Recursos

- [Documentacion oficial](https://docs.aws.amazon.com/)
- [AWS Skill Builder](https://explore.skillbuilder.aws/)

---

*¿Te fue util? Sigueme para mas contenido sobre AWS.*

Happy learning on AWS! 🚀
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="template-cert"></a>
## 📝 Template para guias de certificacion

```markdown
---
title: "Guia SAA-C03: [Dominio]"
published: false
description: Guia completa para el dominio X del examen SAA-C03.
tags: aws, certification, saac03, career
series: Guia SAA-C03
---

# [Dominio]: Guia para el SAA-C03

> **Peso en el examen**: X%
> **Tiempo de estudio**: X horas

---

## 🗺️ Tabla de contenidos

- [Objetivos](#objectives)
- [Servicios clave](#services)
- [Conceptos](#concepts)
- [Comparaciones](#comparisons)
- [Preguntas de practica](#questions)
- [Errores comunes](#mistakes)
- [Recursos](#resources)

---

<a name="objectives"></a>
## 🎯 Objetivos del dominio

- [ ] Objetivo 1
- [ ] Objetivo 2

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="services"></a>
## 🛠️ Servicios clave

| Servicio | Descripcion |
|----------|-------------|
| Servicio 1 | Descripcion |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="concepts"></a>
## 📖 Conceptos fundamentales

### Concepto 1

Explicacion...

> 🎯 **Para el examen**: Punto clave.

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="comparisons"></a>
## ⚖️ Comparaciones importantes

| Aspecto | Servicio A | Servicio B |
|---------|:----------:|:----------:|
| Aspecto 1 | ✅ | ❌ |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="questions"></a>
## ❓ Preguntas de practica

{% details Pregunta 1 %}

**Escenario...**

A) Opcion A
B) Opcion B
C) Opcion C ✅
D) Opcion D

**Explicacion**: ...

{% enddetails %}

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="mistakes"></a>
## ⚠️ Errores comunes

1. **Error 1**: Como evitarlo
2. **Error 2**: Como evitarlo

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="resources"></a>
## 📚 Recursos

- [Documentacion](url)
- [Whitepaper](url)

[⬆️ Volver arriba](#tabla-de-contenidos)
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="checklist"></a>
## ✅ Checklist pre-publicacion

### Contenido

- [ ] TL;DR claro con tiempo y nivel
- [ ] Tabla de contenidos con **anclas HTML** (`<a name="id"></a>`)
- [ ] Todos los enlaces internos funcionan
- [ ] Enlaces "volver arriba" despues de cada seccion
- [ ] Pasos probados en AWS
- [ ] Screenshots actualizados
- [ ] Codigo con syntax highlighting
- [ ] Seccion de troubleshooting
- [ ] Seccion de limpieza

### SEO y metadatos

- [ ] Titulo atractivo (< 128 caracteres)
- [ ] Description optimizada (< 156 caracteres)
- [ ] Tags relevantes (max 4)
- [ ] Cover image (1000x420 px)

### Formato

- [ ] Sin errores de ortografia
- [ ] Tablas renderizando correctamente
- [ ] Liquid tags funcionando (preview)

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="seo"></a>
## 🚀 SEO y engagement

### Titulos que funcionan

```yaml
# Patrones efectivos:
"[Servicio AWS]: [Problema] [Año]"
"Como [Accion] con [Servicio] - Guia Completa"
"[Numero] Tips para [Objetivo] en AWS"
"[Servicio A] vs [Servicio B]: Cuando usar cada uno"

# Ejemplos:
title: "VPC en AWS: Guia Practica desde Cero [2025]"
title: "5 Errores Comunes en IAM que Comprometen tu Seguridad"
title: "S3 vs EFS vs EBS: Guia Definitiva de Storage en AWS"
```

### Horarios de publicacion optimos

| Dia | Hora (UTC) |
|-----|------------|
| Martes | 14:00-16:00 |
| Miercoles | 14:00-16:00 |
| Jueves | 14:00-16:00 |

### Estrategias de engagement

1. Responde comentarios en las primeras 24 horas
2. Comparte en LinkedIn/Twitter
3. Usa series para contenido relacionado
4. Pide feedback al final

[⬆️ Volver arriba](#tabla-de-contenidos)

---

<a name="errores"></a>
## ❌ Errores comunes y soluciones

### Enlaces rotos en ToC

```markdown
❌ PROBLEMA: Confiar en IDs auto-generados
✅ SOLUCION: Usar anclas HTML manuales

<a name="mi-seccion"></a>
## 💡 Mi Sección con Emojis y Acentos

[Link a la seccion](#mi-seccion)
```

### Codigo sin highlighting

`

```markdown
❌ PROBLEMA:
```


aws s3 ls


```

✅ SOLUCION:
```

bash
aws s3 ls


```
```

`

### Tablas mal formateadas

```markdown
❌ PROBLEMA:
|Col1|Col2|
|---|---|
|Data|Data|

✅ SOLUCION:
| Col1 | Col2 |
|------|------|
| Data | Data |
```

### Liquid tags que no funcionan

```markdown
❌ PROBLEMA: {% github usuario/repo no-readme%}
✅ SOLUCION: {% github usuario/repo no-readme %}

# Espacio antes del %}
```

[⬆️ Volver arriba](#tabla-de-contenidos)

---

## 🔧 Herramientas utiles

| Herramienta | Uso | URL |
|-------------|-----|-----|
| Tables Generator | Crear tablas Markdown | tablesgenerator.com |
| Carbon | Screenshots de codigo | carbon.now.sh |
| Draw.io | Diagramas AWS | app.diagrams.net |
| Excalidraw | Diagramas sketch | excalidraw.com |

[⬆️ Volver arriba](#tabla-de-contenidos)

---

*Ultima actualizacion: Enero 2026*
Enter fullscreen mode Exit fullscreen mode

Top comments (0)