Documentación

Introducción

¡Bienvenido a ghostwriter! Esta guía de referencia rápida proporciona ejemplos de escritura en Markdown, un formato de marcado de texto creado por John Gruber. Para más información, visite el sitio web de John Gruber en http://www.daringfireball.net.

ghostwriter integra el uso del procesador cmark-gfm. No obstante, también puede detectar los procesadores Pandoc, MultiMarkdown y cmark. Solo tiene que instalar alguno de estos procesadores y asegurarse de que la ubicación de la instalación esté presente en la variable de entorno PATH de su sistema. ghostwriter detectará la instalación de forma automática durante su inicio y le proporcionará las correspondientes funciones de vista previa HTML en vivo y opciones de exportación.

Encabezados

# Level 1 Heading
## Level 2 Heading ##
###### Level 6 Heading

Level 1 Heading
===============
some text

Level 2 Heading
---------------
some more text

Párrafos

This is a paragraph.
This is another line in the same paragraph using a manual line break.

This is a new paragraph.

Formateo en línea

Puede escribir en cursiva e incluso en negrita de dos formas. La primera consiste en encerrar el texto con asteriscos (*), mientras que la segunda usa signos de subrayado (_).

This is *italics* with asterisks.
This is _italics_ with underscores.

This is **bold** with asterisks.
This is __bold__ with underscores.

También puede escribir en cursiva con negrita mezclándolas de este modo:

This is ***bold italics*** with asterisks.
This is **_bold italics_** mixing.
This is another *__bold italics__*.
etc.

Enlaces

Puede crear enlaces a distintos sitios web:

Click [here](http://url.com "Title") to visit a website.

También puede usar enlaces de referencia:

[This][id] is a reference link which is defined below.

[id]: http://url.com "Title"

Imágenes

Puede incrustar imágenes así:

![alternate text](./image.jpg "Title")

También puede usar la misma sintaxis que con los enlaces de referencia:

![alternate text][id] for a reference defined below.

[id]: ./image.jpg "Title"

Listas

Puede usar listas ordenadas:

1. Item one.
2. Item two.
3. Item three.

Y también listas sin ordenar:

* Item one.
+ Item two.
- Item three.

Puede mezclar y combinar con listas anidadas:

1. Item one.
    * Subitem one.
    * Subitem two.
2. Item two.
    - Subitem one.
    - Subitem two.
3. Item three.
    1. Subitem three.

Bloques de código

Puede sangrar texto con cuatro o más espacios o con un carácter de tabulación para crear bloques de código:

This is a normal paragraph, followed by a code block.
    
    for (int i = 0; i < 10; i++) {
        System.out.println("i = " + i);
    }
    
The above will be displayed as a preformatted block of code.

En algunos convertidores de Markdown, como Pandoc o GitHub, se pueden usar los acentos graves del Markdown de GitHub para delimitar bloques de código en lugar de usar sangría en el bloque, como:

```
for (int i = 0; i < 10; i++) {
    System.out.println("i = " + i);
}
```

Lo anterior también se mostrará como un bloque de código preformateado.

Fragmentos de código

Se pueden usar acentos graves en medio de un párrafo para delimitar código, como esta etiqueta `<html>`. Puede escribir acentos graves literales usando más de un acento grave, como en este ejemplo: `` `acento grave escapado` ``.

Citas en bloque

Puede usar paréntesis angulares como los que se usan en direcciones de correo electrónico para delimitar citas en bloque, del siguiente modo:

> This is a block quote.
>
>> This is a nested block quote.

Líneas horizontales

Use tres o más guiones (-), signos de subrayado (_) o asteriscos (*) para crear líneas horizontales, como:

---

***
___

También puede haber espacios entre cada carácter:

- - -

Extensiones de Markdown

Algunos procesadores de Markdown añaden sintaxis para tablas, notas al pie y otras cosas con el objeto de extender la especificación original de Markdown de John Gruber. A continuación se muestra un ejemplo de nota al pie para Pandoc, MultiMarkdown y otros procesadores que permiten usar dicha extensión:

Here is the body text that has a footnote.[^footnoteid]

[^footnoteid]:  Here is the footnote text.

A continuación se muestra un ejemplo de tabla de Pandoc:

Column One     Column Two
----------     ----------
Row Text 1     Row Text 2
Row Text 1     Row Text 2

Table:  Pandoc sample table.

Este es un ejemplo de tabla de cmark-gfm o MultiMarkdown:

Column One | Column Two
---------- | ----------
Row Text 1 | Row Text 2
Row Text 1 | Row Text 2

Existen todavía más sintaxis de tablas aparte de las que permiten usar estos procesadores de Markdown. Y también existen muchas más extensiones. Para más información sobre estos procesadores, visite los siguientes sitios web:

Puede encontrar la especificación original de Markdown de John Gruber en http://daringfireball.net/projects/markdown/.

Accesos rápidos de teclado

ghostwriter permite usar los siguientes accesos rápidos de teclado para editar Markdown:

Ctrl+B
Aplica formato de negrita (fuerza).
Ctrl+I
Aplica formato de cursiva (énfasis).
Ctrl+K
Aplica formato de tachado.
Ctrl+/
Inserta un comentario HTML en la posición del cursor si no hay texto seleccionado; en caso contrario, convierte el texto seleccionado en un comentario HTML.
Tab
Sangra las líneas de texto seleccionadas.
Mayúsculas+Tab
Elimina el sangrado de las líneas de texto seleccionadas.
Mayúsculas+Intro
Inserta un salto de línea al estilo de Markdown.
Ctrl+Intro
Inserta un salto de línea normal, aunque no se tendrá en cuenta la sangría actual. En otras palabras, si está escribiendo en una línea sangrada y pulsa Ctrl+Intro, no se añadirá sangría a la nueva línea. Tenga en cuenta que el modificador «Ctrl» se puede combinar con el modificador «Mayúsculas» para producir tanto una línea sin sangría como un salto de línea al estilo de Markdown.
Ctrl+.
Convierte la línea actual o las líneas seleccionadas en una cita en bloque.
Ctrl+,
Elimina cualquier formato de cita en bloque de la línea actual o de las líneas de texto seleccionadas.
Ctrl+8
Convierte la línea actual o las líneas seleccionadas en una lista de viñetas con el marcador *. Por ejemplo, si selecciona el texto de las siguientes líneas:
  List item one.
  List item two.

Al pulsar este atajo de teclado se convierten las líneas seleccionada en una lista de viñetas como esta:

  * List item one.
  * List item two.
Ctrl+Mayúsculas+-
Convierte la línea actual o las líneas seleccionadas en una lista de viñetas con el marcador *. Por ejemplo, si selecciona el texto de las siguientes líneas:
  List item one.
  List item two.

Al pulsar este atajo de teclado se convierten las líneas seleccionada en una lista de viñetas como esta:

  - List item one.
  - List item two.
Ctrl+Mayúsculas+=
Si pulsa Ctrl y Mayúsculas con el carácter =, se convierte la línea actual o las líneas seleccionadas en una lista de viñetas con el marcador +. Por ejemplo, si selecciona el texto de las siguientes líneas:
  List item one.
  List item two.

Al pulsar este atajo de teclado se convierten las líneas seleccionada en una lista de viñetas como esta:

  + List item one.
  + List item two.
Ctrl+1
Convierte la línea actual o las líneas seleccionadas en una lista numerada con el marcador .. Por ejemplo, si selecciona el texto de las siguientes líneas:
  List item one.
  List item two.

Al pulsar este atajo de teclado se convierten las líneas seleccionada en una lista numerada como esta:

  1. List item one.
  2. List item two.
Ctrl+0
Convierte la línea actual o las líneas seleccionadas en una lista numerada con el marcador ). Por ejemplo, si selecciona el texto de las siguientes líneas:
  List item one.
  List item two.

Al pulsar este atajo de teclado se convierten las líneas seleccionada en una lista numerada como esta:

  1) List item one.
  2) List item two.
Ctrl+T
Convierte la línea actual o las líneas seleccionadas en elementos de lista de tareas de Markdown al estilo de GitHub. Por ejemplo, si selecciona el texto de las siguientes líneas:
  Important thing to do.
  Another important thing to do.

Al pulsar este atajo de teclado se convierten las líneas seleccionada en una lista de tareas como esta:

  - [ ] Important thing to do.
  - [ ] Another important thing to do.
Ctrl+D
Si la línea de texto actual es un elemento de una lista de tareas de Markdown al estilo de GitHub, al pulsar esta combinación de teclas se conmutará el estado de la tarea, colocando una x en la casilla de verificación si la tarea se ha completado, o eliminando la x si está incompleta. Por ejemplo:
  - [ ] This is an incomplete task.
  - [x] This task as done!
Caracteres coincidentes
Cuando se selecciona texto dentro de una línea, al pulsar cualquier de los caracteres anteriores se encerrará el texto seleccionado con dicho carácter y con su carácter de cierre correspondiente. Por ejemplo, si selecciona la palabra perro y luego introduce el carácter (, la palabra perro se encerrará entre paréntesis y se convertirá en (perro). A continuación se muestra una tabla que muestra el carácter escrito y su correspondiente carácter de cierre:

AperturaCierre
""
''
()
[]
{}
**
__
``
<>

Para activar el emparejamiento automático de caracteres a medida que escribe, marque «Emparejar automáticamente los caracteres al escribir» en la pestaña «Editor» del diálogo de preferencias, al que puede acceder usando la opción del menú `Preferencias->Preferencias...`. También puede personalizar los caracteres que se emparejarán usando el botón «Personalizar caracteres emparejados...».
Arrastrar y soltar archivos de imágenes
Como alternativa a seleccionar la opción Editar->Insertar imagen... de la barra de menú, puede arrastrar y soltar un archivo de imagen desde el sistema de archivos en la ventana del editor. La aplicación insertará el texto en línea de la imagen con la ruta del archivo relativa a la ubicación del documento abierto, o la ruta completa si el documento no tiene título. Por ejemplo:

  ![](../../relative/path/to/your/file.png)

o si el documento no tiene título:

  ![](file:///full/path/to/your/file.png)