Markdown es una sintaxis de formato de texto ligero que convierte texto sencillo en documentos estructurados. Creado en 2004 por John Gruber, es ahora el formato estándar para la documentación, los archivos README, las publicaciones en blogs y la comunicación con los desarrolladores. Esta guía explica qué es Markdown, por qué la gente lo usa y cómo comenzar.
¿Qué es Markdown?
Markdown es una forma de agregar formato al texto plano utilizando caracteres de puntuación simples. Usted escribe en un editor de texto, y el Markdown es renderizado en formato de salida (HTML, PDF, etc.) por un procesador.
Por ejemplo:
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item twoSe presenta como:
Este es un Título
Esto es un Palabra en negrita Y esto es italic.
- El primer punto de la lista
- El segundo punto de la lista
El formato vive en el texto mismo sin XML oculto, sin formato binario, sin codificación propietaria.
¿Por qué fue creado el Markdown?
Antes de Markdown, los escritores web se enfrentaban a una elección: escribir en HTML crudo (tedioso y propenso a errores) o usar un editor WYSIWYG que producía código desordenado. John Gruber diseñó Markdown para ser:
- Legible tal como está Incluso sin renderizar,
**bold**se lee con claridad como énfasis - Escrito por cualquiera Sin software especial, sólo un editor de texto
- Convertible a HTML El formato de salida primario
La especificación original se centró en producir HTML limpio. Pero Markdown desde entonces se ha extendido a docenas de plataformas y formatos de salida.
¿Dónde se utiliza Markdown?
Markdown está en todas partes en la tecnología:
| Plataforma de trabajo | Qué hace Markdown |
|---|---|
| GitHub | README, problemas, peticiones de extracción, wikis |
| Notion | Contenido de la página y documentos |
| Obsidian | Todas las notas en la caja fuerte. |
| WordPress y otras aplicaciones | Publicaciones a través del complemento Markdown |
| GitBook | Páginas de documentación |
| Decaimiento / Discordia | Formato de mensaje |
| Desbordamiento de las pilas | Preguntas y respuestas |
| Jekyll , Hugo y Astro . | Publicaciones en blogs y páginas estáticas |
| Cuadernos de Júpiter | Celdas de documentación |
Si usted escribe cualquier contenido técnico, casi con seguridad se ha encontrado Markdown.
En el caso de los Estados miembros: Palabra: Principales diferencias
| Aspecto | Word | Markdown |
|---|---|---|
| El formato | En el caso de las operaciones binarias (.docx) | Texto sencillo (.md) |
| La portabilidad | Requiere Word o una aplicación compatible | Se abre en cualquier editor de texto |
| Control de las versiones | Difícil (diferencias binarias) | Fácil (diferencias Git línea por línea) |
| Rendición | Integrado en la aplicación | Requiere un renderizado Markdown |
| Curva de aprendizaje | WYSIWYG (sin aprendizaje) | Requiere el aprendizaje de la sintaxis |
| Apoyo a las plataformas | Ecosistema de Microsoft | Herramientas universales para desarrolladores |
Si usted tiene Word documentos que desea convertir a Markdown, WordToMD se encarga de esto al instante sin registro, sin subir.
La sintaxis Markdown básica
Estos son los elementos más comunes:
Títulos y rótulos
# Heading 1
## Heading 2
### Heading 3No se puede hacer. Markdown Guía de encabezados para la referencia completa.
El énfasis
**Bold text**
*Italic text*
~~Strikethrough~~Las listas
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. ThirdEnlaces
[Link text](https://example.com)Imágenes
Código
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |No se puede hacer. Markdown Tablas: una guía completa.
Cuotas de bloque
> This is a blockquote.
> It can span multiple lines.Markdown Sabores
Markdown no es un solo estándar hay varias variantes:
- CommonMark Una especificación estricta y sin ambigüedades
- GitHub con sabor Markdown (GFM) CommonMark + tablas, listas de tareas, respuestas, enlaces automáticos
- Multimarcado Añade notas a pie de página, citas y metadatos
- ¿Qué es lo que está sucediendo? Más rico en características, utilizado por el convertidor Pandoc
La mayoría de las plataformas soportan al menos CommonMark. GitHub, Obsidian, y GitBook usan GFM. Para una referencia completa, véase Markdown Sintaxis guía rápida.
Cómo escribir Markdown
No necesitas un software especial. Las opciones incluyen:
- Código VS Editor gratuito y potente con vista previa Markdown incorporada
- Obsidian Markdown aplicación para tomar notas con vista gráfica
- Tipora y sus derivados WYSIWYG Markdown editor
- iA Escritor Entorno de escritura centrado
- Cualquier editor de texto sencillo Cuaderno de notas, TextEdit, vim, emacs
Convertir entre Markdown y otros formatos
Si usted tiene Word documentos para convertir a Markdown, WordToMD lo hace en segundos completamente gratis, sin necesidad de subir archivos.
Para el reverso (Markdown a Word o PDF), herramientas como Pandoc manejan esta conversión. No se puede hacer. Pandoc, mensaje para Markdown. para las instrucciones de configuración.
FAQ
¿Es Markdown un lenguaje de programación? - No, no puedo. Markdown es un lenguaje de marcado que describe el formato, no la lógica o la computación.
¿Puedo usar Markdown en Microsoft Word? Word no hace Markdown de forma nativa, pero hay Word complementos que agregan Markdown soporte. Alternativamente, convertir Word a Markdown con WordToMD y utilizar un editor Markdown.
¿Es Markdown bueno para documentos largos? Sí, con buena estructura de dirección. Los documentos muy largos se benefician de la división en múltiples archivos (como en GitBook o Obsidian bóvedas).
¿Qué extensión de archivo utiliza Markdown?
.md es el estándar. .markdown también es válido. Algunas plataformas utilizan .mdx para Markdown con componentes JSX (React).
Conclusión
Markdown es un formato sencillo y potente que se ha convertido en la lengua franca de la escritura técnica. Es legible como texto plano, renderiza hermosamente y funciona con todas las principales herramientas de desarrolladores. Si eres nuevo, comienza con el Markdown Sintaxis guía rápida y tratar de convertir su primer documento Word en WordToMD.