1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
---
breaks: false
repo: https://mutabit.com/repos.fossil/documentaton/
translations:
- en: https://docutopia.tupale.co/inkit:r3p:agiledoc#
- es: https://docutopia.tupale.co/documentaton:agiledoc.es#
sync:
- translations://es
- repo://es/capitulos/doc-agil.md
Pending: Traducir el documento de inglés a español.
---
# Markdown: Documentación ágil y estructurada
## Introducción
|
>
<
|
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
---
breaks: false
title: "Markdown: Documentación ágil y estructurada "
repo: https://mutabit.com/repos.fossil/documentaton/
translations:
- en: https://docutopia.tupale.co/inkit:r3p:agiledoc#
- es: https://docutopia.tupale.co/documentaton:agiledoc.es#
sync:
- translations://es
- repo://es/capitulos/doc-agil.md
Pending: Traducir el documento de inglés a español.
---
{width=70%}
# Introducción
Las pantallas se están volviendo más ubicuas y diversas.
Tabletas, teléfonos celulares, computadores portátiles y de escritorio y los libros son aparatos donde expresamos
y nos aproximamos a ideas, causas e historias.
Esto configura un paisaje de medios donde estamos leyendo y escribiendo desde y para distintos aparatos y
factores de forma.
En tal panorama diverso, software popular, como las _suites_ de oficina, pueden ser consumir demasiados recursos y
|
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
:::
Esta parte de la obra te proveerá con los enlaces sobre cómo usar dicha Markdown y los recuros que puedes encontrar
para profundizar en este camino.
Debido a que hay muchos recursos en línea sobre éste, más que repetirlos acá, lo que haremos será proveerte con un
tour guiado sobre cómo estos recursos están organizados para ir de lo simple a lo complejo.
## Herramientas y ejemplos relacionados
|
|
|
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
:::
Esta parte de la obra te proveerá con los enlaces sobre cómo usar dicha Markdown y los recuros que puedes encontrar
para profundizar en este camino.
Debido a que hay muchos recursos en línea sobre éste, más que repetirlos acá, lo que haremos será proveerte con un
tour guiado sobre cómo estos recursos están organizados para ir de lo simple a lo complejo.
# Herramientas y ejemplos relacionados
Esta sección muestra algunas extensiones y variantes de Markdown, ejemplos de obras particulares y también
herramientas que pueden ser usadas para escribir en él.
:::success
::: {.admonition}
<i class="fa fa-wrench fa-fw"></i> Visita los siguientes enlaces para adquirir una visión panorámica de cómo está siendo usando Markdown y por qué.
|
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
- [ ] [CodiMD][codimd]: Un editor colaborativo para Markdown con resaltado sintáctico, previsulización en vivo
permisos granulares sobre los documentos y soporte para varias extensiones de Markdown como bloques
de metadatos en Yaml, _smileys_, bloques de alerta y trozos de código, entre otros.
- [ ] [Markor](https://github.com/gsantner/markor ): Un editor de texto para Android basado en Markdown para notas, agenda y enlaces.
:::
:::
## Aprendiendo los fundamentos
|
|
|
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
- [ ] [CodiMD][codimd]: Un editor colaborativo para Markdown con resaltado sintáctico, previsulización en vivo
permisos granulares sobre los documentos y soporte para varias extensiones de Markdown como bloques
de metadatos en Yaml, _smileys_, bloques de alerta y trozos de código, entre otros.
- [ ] [Markor](https://github.com/gsantner/markor ): Un editor de texto para Android basado en Markdown para notas, agenda y enlaces.
:::
:::
# Aprendiendo los fundamentos
Estos pasos te permitirán aprender las bases de Markdown de una manera progresiva.
Hay muchos recursos para aprenderlo en línea, así que no vamos a repetirlos acá.
Sólo vamos a introducir algunas modificaciones mínimas para mejorar la experiencia de aprendizaje.
Algunas de las experiencias estarán relacionadas con leer, mientras otras requerirán hacer..
:::warning
|