C-x C-f Abrir un archivo. Emacs pide el nombre del archivo en la parte de abajo C-x C-s Guardar un archivo C-x C-c Salir de Emacs

C-g Abortar comando (salir de problemas)

En los siguientes comandos las flechas también funcionan:

C-f Mover cursor hacia adelante (forward) C-b Mover cursor hacia atrás (backwards) C-n Mover cursor a la siguiente línea C-p Mover cursor a la línea anterior

C-a Mover cursor al inicio de la línea C-e Mover cursor al final de la línea

C-v Mover cursor una pantalla abajo M-v Mover cursor una pantalla arriba

M-f Mover cursor una palabra adelante M-b Mover cursor una palabra atrás M-> Mover cursor al final del archivo M-< Moved cursor al inicio del archivo

C-u 7 C-n Mover cursor 7 líneas adelante C-u 10 C-p Mover cursor 10 líneas atrás

C-l Redibujar el texto dejando el cursor en el centro de la pantalla

C-k Cortar texto, desde la posición del cursor hasta el final de la línea C-spc Inicia el marcado de bloque de texto, el bloque se agranda con las teclas de movimiento C-W Corta el bloque M-W Copia el bloque C-y Pegar el texto

C-s Búsqueda incremental del cursor hacia adelante, el cursor se mueve conforme se teclea, dar enter para aceptar

C-s enter enter para buscar de nuevo el mismo patrón

C-r Búsqueda incremental del cursor hacia atrás, el cursor se mueve conforme se teclea, dar enter para aceptar

Inicie Emacs, abra archivos, edítelos y guárdelos. Es decir utilice Emacs para editar algunos archivos de texto.

Con los comandos anteriores se puede usar emacs como otro editor cualquiera. Pero hay mas, mucho mas en Emacs.

Un documento de Org es un archivo de texto simple con terminación '.org'. Un archivo '.org' tiene marcas que son interpretadas por Org para que el archivo se vea bonito en pantalla. Al editar un archivo con Org estas marcas son muy fáciles de introducir. En cierto sentido se podría decir que Org es un lenguaje de marcas como el html y otros que hay por ahí, pero es mucho más que eso.

Los encabezados empiezan con '*'

* Esto encabeza una sección: los encabezados empiezan con '*'

** Encabezado de subsección: empiezan con '**'

***  Encabezado de sub-subsección: empiezan con '***' 

Se pueden introducir texto en ∗negritas∗, /italicas/, _Subrayado_, +rayado+,

Se una línea empieza con guión '-' o suma '+' entonces se reconoce como una lista. La lista termina cuando se encuentra un guión con diferente sangría.

- Item 1 primario
  - item 1 secundario 
    1. item a
    2. item b
  - item 2 secundario 
    1. item a
    2. item b
- Item 2 primario
  - item 3 secundario 
    1. item a
    2. item b
  - item 4 secundario 
    1. item a
    2. item b

Produce:

• Item 1 primario
  • item 1 secundario
    1. item a
    2. item b
  • item 2 secundario
    1. item a
    2. item b
• Item 2 primario
  • item 3 secundario
    1. item a
    2. item b
  • item 4 secundario
    1. item a
    2. item b

Un documento en org tiene la estructura de un arbol con los encabezados como nodos. Org puede ocultar/mostrar un nodo y sus hijos con el uso de una sola tecla: "Tab". De esta manera se controla la visibilidad de distintas partes del documento; así Org simplifica la edición de documentos complejos.

Se pueden cambiar la estructura de un documento de manera rápida y sencilla:

• 'M-←' Incrementa al nivel de un encabezado
• 'M- →' Decrementa el nivel de un encabezado
• 'M-↓' Mueve un encabezado y su contenido hacia abajo
• 'M-↑' Mueve un encabezado y su contenido hacia arriba

Estos comandos no sólo funcionan con encabezados, también funcionan con otros bloques de texto como párrafos, listas etc.

Org puede exportar a otros formatos. Si se ejecuta (M-x) org-export-dispatch se abre un menú con las opciones. Se abre un menú con varias opciones entre las cuales se encuentra:

• Ascii
• Odt: El formato de libre office
• Html
• Latex
• Pdf (via Latex)

El pdf es generado via Latex por lo que Latex debe estar instalado.

Normalmente la función org-export-dispatch está asociada a la secuencia 'C-c C-e'

Se puede especificar como será exportado el documento. Por ejemplo en el caso de Latex, se puede especificar el tipo de documento (la clase), el tamaño y tipo de fuente, el idioma etc. Haciendo la analogía con Latex, yo le llamo el preámbulo, sin embargo, en Org, estas opciones pueden estar en cualquier lugar del documento.

Yo pongo al inicio las siguientes líneas

#+TITLE: Titulo del documento
#+SUBTITLE: Un subtítulo

#+AUTHOR: Juan Pérez
#+EMAIL: correo.electronico@gmail.com

#+DATE: \today

que se explican por si mismas.

Al final en una sección etiquetada como :noexport: pongo las opciones de exportación separadas en tres subsecciones. Los encabezados de secciones pueden llevar etiquetas. Una etiqueta no es más que una cadena con ':' al inicio y al final. Las etiquetas tienen varios usos en Org. La etiqueta :noexport: en un encabezado le dice a Org que esa sección y sus hijos no se exportarán.

Para iniciar la sección de opciones de exportación escribo literalmente:

* Opciones de exportación                      :noexport:

Dento de esta sección hay tres subsecciones:

• Las opciones generales. Estas opciones están explicadas en el manual de Org.

** Opciones generales

#+OPTIONS: ':nil *:t -:t ::t <:t H:4 \n:nil ^:t arch:headline
#+OPTIONS: author:nil broken-links:nil c:nil creator:nil
#+OPTIONS: d:(not "LOGBOOK") date:t e:t email:nil f:t inline:t num:t
#+OPTIONS: p:nil pri:nil prop:nil stat:t tags:t tasks:t tex:t
#+OPTIONS: timestamp:t title:t toc:nil todo:t |:t
#+LANGUAGE: sp
#+SELECT_TAGS: export
#+EXCLUDE_TAGS: noexport

• Las opciones de LaTeX. Org pasa estas opciones al compilador LaTeX. Org genera un pdf via LaTeX. Es decir primero genera el LaTeX y luego con PdfLatex genera el pdf.

** Opciones de LaTeX  
#+LATEX_CLASS: article
#+LATEX_CLASS_OPTIONS: [letterpaper, 11pt]

#+LATEX_HEADER: \usepackage{amssymb}
#+LATEX_HEADER: \usepackage{siunitx}
#+LATEX_HEADER: \usepackage[margin=1in]{geometry}
#+LATEX_HEADER: \usepackage[spanish,mexico]{babel}
#+LATEX_HEADER: \usepackage{lmodern}
#+LATEX_HEADER: \usepackage{svg}
#+LATEX_HEADER: \usepackage{xcolor}
#+LATEX_HEADER: \hypersetup{colorlinks, linkcolor={red!50!black}, citecolor={blue!50!black}, urlcolor={blue!80!black}}

,# +LATEX: \tableofcontents
,# +LATEX: \listoftables
,# +LATEX: \listoffigures

#+LATEX_HEADER: \newcommand{\N}{\mathbb{N}}
#+LATEX_HEADER: \newcommand{\Z}{\mathbb{Z}}
#+LATEX_HEADER: \newcommand{\Q}{\mathbb{Q}}
#+LATEX_HEADER: \newcommand{\R}{\mathbb{R}}

#+LATEX_COMPILER: pdflatex

• Las opciones de html. Org puede exportar a html, para este efecto se pueden adecuar varias opciones. Entre ellas la hoja de estilo (css). En la red hay varias hojas de estilo para Org. Por ejemplo: Solarized. En las opciones se usa como hoja de estilo el archivo org.css que debe encontrarse en el mismo folder que el html generado.

**  Opciones de html
#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="org.css"/>
#+OPTIONS: html-link-use-abs-url:nil html-postamble:auto
#+OPTIONS: html-preamble:t html-scripts:t html-style:t
#+OPTIONS: html5-fancy:nil tex:t
#+HTML_DOCTYPE: xhtml-strict
#+HTML_CONTAINER: div
#+DESCRIPTION:
#+KEYWORDS:
#+HTML_LINK_HOME:
#+HTML_LINK_UP:
#+HTML_MATHJAX:
#+HTML_HEAD:
#+HTML_HEAD_EXTRA:
#+SUBTITLE:
#+INFOJS_OPT:
#+LATEX_HEADER:

Es muy sencillo poner un enlace (link) a un sitio externo en un documento de Org. La sintaxis es [[direccion.de.la.url][Descripción]]. El código [[https://orgmode.org/][Sitio de Org]] produce el link Sitio de Org.

Esta sintaxis se usa también para referirse a elementos del propio documento como figuras, tablas, secciones, etc. En estos casos no se usa la parte de la descripción.

Cuando se introduce [[un-link]] Org no muestra los corchetes, por lo que puede ser confuso cambiarlo después. Para editar un link ponga el cursor en el link y teclee C-c C-l.

El siguiente bloque ejemplifica un caso típico para introducir una figura.

• La línea que inicia con #+caption se explica por si sola.
• La línea #+NAME: establece un nombre para la figura. Ese nombre se utiliza para referirse a la figura.
• Las lineas #+ATTR_HTML: y #+ATTR_LATEX: se refieren a los atributos que la figura tendrá si se exporta a Html o Latex; en este caso se establece un ancho de 500 pixeles en Html y de 4 pulgadas en Latex. Note que no se podría establecer la medida en pulgadas si se exporta a Html.
• La línea [[./fig/ejemplo.png]] indica que ahí va la figura llamada 'ejemplo.png' que está en el subfolder 'fig'. En Org varios elementos se refieren con la sintaxis [[link-al-elemento]]. Aquí esta sintaxis se usa para incluir la figura en el documento.

#+CAPTION: Figura de ejemplo 
#+NAME: fig:ejemplo
#+ATTR_HTML: :width 500px
#+ATTR_LATEX: :width 4.0in
[[./fig/ejemplo.png]]

El bloque anterior da como resultado:

Para referirse a la figura se usa la misma sintaxis de [[link-al-elemento]], pero ahora con el nombre de la figura; es decir el texto 'vease [[fig:ejemplo]]' da como resultado 'vease 1'.

Org puede editar tablas simples de manera sencilla. Consulte Tablas para información detallada. El funcionamiento básico es como sigue:

• Cualquier línea que después de 0 o más espacios en blanco, seguido de | se considera el inicio de una tabla.
• El carácter | también se usa para separar las columnas.
• Cualquier línea que empieza con |- se considera como una línea horizontal.
• Los renglones antes de la primer línea horizontal se consideran encabezados.
• El número de espacios en blanco antes del | determinan el identado de la tabla.
• Cada vez que se teclea Tab, Enter o C-c C-c dentro de la tabla, ésta actualiza el ancho de las columnas para que los datos se vean bien.
• Tab además mueve el cursor al siguiente campo y Enter introduce una nueva fila.
• Si se teclea C-c seguido de Enter se introduce una linea y una nueva fila. manera automática para .

En Org una tabla se despliega así.

  | mes | día |  año |
  |-----+-----+------|
  |  12 |  23 | 2017 |
  |-----+-----+------|

Pero al exportarse se ve así

Para poder referirse a una tabla hay ponerle un nombre con #+NAME: nombre y titulo con #+CAPTION: Titulo de la tabla. El nombre permite referirnos a la tabla. El bloque

#+CAPTION:  Tabla de ejemplo
#+NAME: tab:ejemplo
  | Apellido paterno | Apellido materno | Nombre |
  |------------------+------------------+--------|
  | Pérez            | Hernández        | Juan   |
  |------------------+------------------+--------|

da como resultado

Ahora nos podemos referir a la tabla anterior usando [[tab:ejemplo]] que resulta en una referencia a la tabla 1.

Se pueden introducir fórmulas en un documento de Org de manera casi igual a Latex. Org es bastante flexible en este aspecto, aunque aún hay cosas que se pueden en LaTeX pero no en Org.

Los encabezados de Org se exportan como secciones. Para referirse a ellas dentro del documento se puede agregar inmediatamente después del encabezado una etiqueta de la forma <<secxx>> y despues referirse a la sección como [[secxx]]. Así se creo la referencia a la sección 1.

También es posible referirse a la sección usando el propio texto de la sección. Por ejemplo si una sección se llama * Introducción se puede referirse a la misma con [[* Introducción]]. Así se creó la siguiente referencia a la sección 1

Para introducir un bloque de código se utiliza la sintaxis

#+NAME: <<nombre>>
#+BEGIN_SRC <<lengjuaje>> 
<<linea 1 del código>>
...
<<linea n del código>>
#+END_SRC

donde <<nombre>> es un nombre con que podemos referirnos al bloque y <<lenguaje>> es el lenguaje en el que está el bloque. El siguiente ejemplo está en lenguaje C

#+NAME: cod:hw 
#+BEGIN_SRC C
    #include <stdio.h>
    int main(int argc, char *argv[]) {
         printf("hello world\n");
         return 0;}
#+END_SRC

y produce

#include <stdio.h>
int main(int argc, char *argv[]) {
  printf("hello world\n");
  return 0;}

Nos podemos referir al código con [[cod:hw]] que resulta en el listado 1.

A mi me gusta escribir los documentos de tal manera que se evite referirse al codigo después. En este caso +NAME: y #+CAPTION: no son necesarios.

Observe que Org produce código con colores. Org reconoce y colorea la sintaxis de muchos lenguajes, pero hay que especificar qué lenguajes se usarán cuando Emacs inicia.

Org puede hacer mucho más con los bloques de código que lo expuesto aquí. Explorar estas capacidades está fuera del alcance de este documento.

Para crear una nota al pie se usa la sintaxis [fn:<etiqueta>: Texto de la nota], donde <etiqueta> es un nombre que puede usarse para referirse nuevamente a la nota. Para referirse de nuevo a la nota dentro del texto se usa [fn:<etiqueta> Texto donde se cita a la nota].

Note que cuando se crea la nota, se ponen dos puntos : antes y después de la etiqueta, mientras que cuando se cita nuevamente los dos puntos solo van antes de etiqueta.

Se pueden definir notas al pie sin asignarle una etiqueta con la siguiente sintaxis [fn:: Texto de la nota]. En este caso no nos podremos referir a esa nota después. El resto de esta subsección explica el uso de las notas al pie. El texto se creó utilizando la sintaxis explicada.

Cuando en un texto se explica una idea se deben evitar¹ elementos innecesarios. Una nota que sólos se citará una vez no necesita nombre². La nota con nombre se puede citar de nuevo¹.

Insertar citas a referencias bibliográficas es un poco más complicado que con las figuras y tablas. Entre otras cosas porque además del documento Org se requiere un documento adicional donde estén las referencias. Generalmente éste es un documento bibtex (.bib).

A continuación se describen algunas opciones para hacer documentos con referencias en Org, pero antes es necesario explicar como se puede ejecutar bibtex desde Org para que las referencias puedan ser incluidas.