Este es el comando pandoc que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
pandoc - convertidor de marcado general
SINOPSIS
pandoc [opciones] [fichero de entrada] ...
DESCRIPCIÓN
Pandoc es una biblioteca de Haskell para convertir de un formato de marcado a otro, y un
herramienta de línea de comandos que utiliza esta biblioteca. Puede leer Markdown, CommonMark, PHP Markdown
Markdown adicional, con sabor a GitHub y (subconjuntos de) Textil, reStructuredText, HTML, LaTeX,
Marcado de MediaWiki, marcado TWiki, marcado de Haddock, OPML, modo Org de Emacs, DocBook, txt2tags,
EPUB, ODT y Word docx; y puede escribir texto sin formato, Markdown, CommonMark, PHP Markdown
Extra, Markdown con sabor a GitHub, reStructuredText, XHTML, HTML5, LaTeX (incluido beamer
presentaciones de diapositivas), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
Marcado de MediaWiki, marcado de DokuWiki, marcado de Haddock, EPUB (v2 o v3), FictionBook2, Textile,
páginas de manual de groff, modo Emacs Org, AsciiDoc, InDesign ICML y Slidy, Slideous, DZSlides,
Revela.js o presentaciones de diapositivas HTML S5. También puede producir salida PDF en sistemas donde LaTeX,
ConTeXt o wkhtmltopdf está instalado.
La versión mejorada de Markdown de Pandoc incluye sintaxis para notas al pie, tablas,
listas ordenadas, listas de definiciones, bloques de código delimitados, superíndices y subíndices,
tachado, bloques de metadatos, tablas de contenido automáticas, matemáticas LaTeX incrustadas, citas,
y Markdown dentro de elementos de bloque HTML. (Estas mejoras, que se describen a continuación en
Markdown de Pandoc, se puede desactivar usando el formato de entrada o salida markdown_strict).
A diferencia de la mayoría de las herramientas existentes para convertir Markdown a HTML, que utilizan expresiones regulares
sustituciones, pandoc tiene un diseño modular: consta de un conjunto de lectores, que analizan
texto en un formato dado y producen una representación nativa del documento, y un conjunto de
escritores, que convierten esta representación nativa en un formato de destino. Por lo tanto, agregando un
El formato de entrada o salida solo requiere agregar un lector o escritor.
Debido a que la representación intermedia de pandoc de un documento es menos expresiva que muchas de las
los formatos entre los que convierte, uno no debe esperar conversiones perfectas entre cada
formato y todos los demás. Pandoc intenta preservar los elementos estructurales de un
documento, pero no detalles de formato como el tamaño del margen. Y algunos elementos del documento,
como tablas complejas, pueden no encajar en el modelo de documento simple de pandoc. Mientras
conversiones de Markdown de pandoc a todos los formatos aspiran a ser perfectas, conversiones de
Se puede esperar que los formatos más expresivos que Markdown de pandoc tengan pérdidas.
Gracias a pandoc
Si no es correcto fichero de entrada se especifica, la entrada se lee desde stdin. De lo contrario, la archivos de entrada están
concatenados (con una línea en blanco entre cada uno) y utilizados como entrada. La salida va a stdout by
predeterminado (aunque salida a stdout está deshabilitado para la salida odt, docx, epub y epub3
formatos). Para la salida a un archivo, use la opción -o:
pandoc -o salida.html entrada.txt
De forma predeterminada, pandoc produce un fragmento de documento, no un documento independiente con un
encabezado y pié de página. Para producir un documento independiente, use la marca -s o --standalone:
pandoc -s -o salida.html entrada.txt
Para obtener más información sobre cómo se producen los documentos independientes, consulte Plantillas, a continuación.
En lugar de un archivo, se puede proporcionar un URI absoluto. En este caso, pandoc buscará el
contenido usando HTTP:
pandoc -f html -t rebaja http://www.fsf.org
Si se proporcionan varios archivos de entrada, pandoc los concatenará todos (con líneas en blanco
entre ellos) antes de analizar. Esta función está deshabilitada para formatos de entrada binaria como
EPUB, odt y docx.
El formato de la entrada y la salida se puede especificar de forma explícita mediante las opciones de la línea de comandos.
El formato de entrada se puede especificar usando las opciones -r / - leer o -f / -, la salida
formato usando las opciones -w / - write o -t / - to. Por lo tanto, para convertir hello.txt de Markdown
a LaTeX, puede escribir:
pandoc -f markdown -t látex hello.txt
Para convertir hello.html de HTML a Markdown:
pandoc -f html -t markdown hola.html
Los formatos de salida admitidos se enumeran a continuación en la opción -t / - to. Entrada admitida
Los formatos se enumeran a continuación bajo la opción -f / - from. Tenga en cuenta que el primero, textil, látex,
y los lectores de html no están completos; hay algunas construcciones que no analizan.
Si el formato de entrada o salida no se especifica explícitamente, pandoc intentará adivinarlo
de las extensiones de los nombres de archivo de entrada y salida. Así, por ejemplo,
pandoc -o hola.tex hola.txt
convertirá hello.txt de Markdown a LaTeX. Si no se especifica ningún archivo de salida (de modo que
la salida va a stdout), o si se desconoce la extensión del archivo de salida, el formato de salida
predeterminado en HTML. Si no se especifica ningún archivo de entrada (para que la entrada provenga de stdin), o
Si se desconocen las extensiones de los archivos de entrada, se asumirá que el formato de entrada es
Reducción a menos que se especifique explícitamente.
Pandoc utiliza la codificación de caracteres UTF-8 tanto para la entrada como para la salida. Si tu local
La codificación de caracteres no es UTF-8, debe canalizar la entrada y la salida a través de iconv:
iconv -t utf-8 entrada.txt | pandoc | iconov -f utf-8
Tenga en cuenta que en algunos formatos de salida (como HTML, LaTeX, ConTeXt, RTF, OPML, DocBook y
Texinfo), la información sobre la codificación de caracteres se incluye en el encabezado del documento,
que solo se incluirá si usa la opción -s / - independiente.
Creamos a (PDF)
Para producir un PDF, especifique un archivo de salida con una extensión .pdf. De forma predeterminada, pandoc
use LaTeX para convertirlo a PDF:
pandoc prueba.txt -o prueba.pdf
La producción de un PDF requiere que se instale un motor LaTeX (consulte --latex-engine, a continuación),
y asume que los siguientes paquetes LaTeX están disponibles: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, listados (si se usa la opción --listings), fancyvrb,
longtable, booktabs, graphicx y grffile (si el documento contiene imágenes), hyperref,
ulem, geometría (con el conjunto de variables de geometría), setpace (con linestretch) y babel
(con lang). El uso de xelatex o lualatex como motor LaTeX requiere fontspec;
xelatex usa mathspec, poliglosia (con lang), xecjk y bidi (con la variable dir
colocar). Los paquetes upquote y microtype se utilizan si están disponibles, y csquotes se utilizará
para puntuación inteligente si se agrega a la plantilla o se incluye en cualquier archivo de encabezado. El
Los paquetes natbib, biblatex, bibtex y biber se pueden usar opcionalmente para la cita.
representación. Estos se incluyen con todas las versiones recientes de TeX Live.
Alternativamente, pandoc puede usar ConTeXt o wkhtmltopdf para crear un PDF. Para hacer esto, especifique
un archivo de salida con una extensión .pdf, como antes, pero agregue -t contexto o -t html5 al
línea de comando.
La salida PDF se puede controlar usando variables para LaTeX (si se usa LaTeX) y variables
para ConTeXt (si se utiliza ConTeXt). Si se usa wkhtmltopdf, entonces las variables margin-left,
margin-right, margin-top, margin-bottom y paperize afectarán la salida, al igual que
--css.
OPCIONES
General opciones
-f FORMATO, -r FORMATO, --desde =FORMATO, --read =FORMATO
Especifique el formato de entrada. FORMATO puede ser nativo (Haskell nativo), json (versión JSON de
AST nativo), markdown (Markdown extendido de pandoc), markdown_strict (original
Markdown no extendido), markdown_phpextra (PHP Markdown Extra), markdown_github
(GitHub-Flavored Markdown), commonmark (CommonMark Markdown), textil (Textile),
rst (texto reestructurado), html (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (modo Org de Emacs), mediawiki
(Marcado de MediaWiki), twiki (marcado de TWiki), eglefino (marcado de eglefino) o látex
(Látex). Si se agrega + lhs a markdown, rst, latex o html, la entrada será
tratado como fuente alfabetizada de Haskell: consulte Soporte alfabetizado de Haskell, a continuación. Reducción
Las extensiones de sintaxis se pueden habilitar o deshabilitar individualmente agregando + EXTENSIÓN
o -EXTENSION al nombre del formato. Así por ejemplo,
markdown_strict + footnotes + definition_lists es un Markdown estricto con notas al pie y
listas de definiciones habilitadas, y markdown-pipe_tables + hard_line_breaks es de pandoc
Rebajas sin tablas de tubos y con saltos de línea duros. Ver Markdown de Pandoc,
a continuación, para obtener una lista de extensiones y sus nombres.
-t FORMATO, -w FORMATO, --to =FORMATO, --escribir =FORMATO
Especifique el formato de salida. FORMATO puede ser nativo (Haskell nativo), json (versión JSON
de AST nativo), sin formato (texto sin formato), Markdown (Markdown extendido de pandoc),
markdown_strict (Markdown original no extendido), markdown_phpextra (Markdown PHP
Extra), markdown_github (Markdown con sabor a GitHub), commonmark (CommonMark
Markdown), primero (texto reestructurado), html (XHTML), html5 (HTML5), látex (LaTeX),
beamer (presentación de diapositivas de beamer de LaTeX), contexto (ConTeXt), man (groff man), mediawiki
(Marcado de MediaWiki), dokuwiki (marcado de DokuWiki), textil (Textile), org (Emacs Org
modo), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), documento abierto
(OpenDocument), odt (documento de texto de OpenOffice), docx (Word docx), eglefino (eglefino
marcado), rtf (formato de texto enriquecido), epub (libro EPUB v2), epub3 (EPUB v3), fb2
(Libro electrónico FictionBook2), asciidoc (AsciiDoc), icml (InDesign ICML), slidy (Slidy HTML
y presentación de diapositivas de JavaScript), slideous (Slideous HTML y presentación de diapositivas de JavaScript),
dzslides (DZSlides HTML5 + presentación de diapositivas javascript), reveljs (revel.js HTML5 +
presentación de diapositivas de JavaScript), s5 (presentación de diapositivas de HTML y JavaScript de S5) o la ruta de una
escritor lua personalizado (consulte Escritores personalizados, a continuación). Tenga en cuenta que odt, epub y epub3
la salida no se dirigirá a stdout; un nombre de archivo de salida debe especificarse usando
la opción de salida -o / -. Si se agrega + lhs a markdown, rst, latex, beamer, html,
o html5, la salida se procesará como fuente Haskell alfabetizada: consulte Literate
Soporte de Haskell, a continuación. Las extensiones de sintaxis de Markdown se pueden habilitar individualmente o
inhabilitado agregando + EXTENSION o -EXTENSION al nombre del formato, como se describe
arriba bajo -f.
-o ARCHIVO, --salida =ARCHIVO
Escribir salida en ARCHIVO en lugar de stdout. Si ARCHIVO es -, la salida irá a stdout.
(Excepción: si el formato de salida es odt, docx, epub o epub3, la salida a stdout es
discapacitado.)
--data-dir =De miembros
Especifique el directorio de datos del usuario para buscar archivos de datos de pandoc. Si esta opcion es
no especificado, se utilizará el directorio de datos de usuario predeterminado. Esto es, en Unix:
$ INICIO / .pandoc
en Windows XP:
C: \ Documents And Settings \ USERNAME \ Application Data \ pandoc
y en Windows Vista o posterior:
C: \ Users \ USERNAME \ AppData \ Roaming \ pandoc
Puede encontrar el directorio de datos de usuario predeterminado en su sistema mirando el
salida de pandoc --version. Un reference.odt, reference.docx, epub.css, templates,
El directorio slidy, slideous o s5 colocado en este directorio anulará el de pandoc
valores predeterminados normales.
- finalización rápida
Genere un script de finalización de bash. Para habilitar la finalización de bash con pandoc, agregue esto
a su .bashrc:
eval "$ (pandoc --bash-completacion)"
--verboso
Proporcione una salida de depuración detallada. Actualmente, esto solo tiene efecto con la salida PDF.
-v, --versión
Versión impresa.
-h, --ayuda
Mostrar mensaje de uso.
Testimoniales opciones
-R, --parse-crudo
Analizar códigos HTML intraducibles y entornos LaTeX como HTML sin procesar o LaTeX,
en lugar de ignorarlos. Afecta solo la entrada HTML y LaTeX. HTML sin formato puede ser
impreso en Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, revel.js,
y salida S5; Raw LaTeX se puede imprimir en Markdown, reStructuredText, LaTeX y
Salida de ConTeXt. El valor predeterminado es que los lectores omitan los códigos HTML intraducibles.
y entornos LaTeX. (El lector de LaTeX pasa a través de LaTeX intraducible
comandos, incluso si no se especifica -R.)
-S, --inteligente
Produzca resultados tipográficamente correctos, convirtiendo comillas rectas en comillas entrecruzadas,
--- a guiones largos, - guiones cortos, y ... a elipses. Los espacios que no se rompen son
insertado después de ciertas abreviaturas, como "Sr." (Nota: esta opción está seleccionada
automáticamente cuando el formato de salida es látex o contexto, a menos que --no-tex-ligatures
se utiliza. No tiene ningún efecto para la entrada de látex).
- guiones viejos
Selecciona el comportamiento pandoc <= 1.8.2.1 para analizar guiones inteligentes: - antes de un número
es un en-dash y - es un em-dash. Esta opción se selecciona automáticamente para
insumo textil.
--base-header-level =NÚMERO
Especifique el nivel base para los encabezados (el valor predeterminado es 1).
--clase-código-sangrado =CLASES
Especifique las clases que se utilizarán para los bloques de código con sangría, por ejemplo, perl, numberLines o
haskell. Varias clases pueden estar separadas por espacios o comas.
--default-image-extension =EXTENSIÓN
Especifique una extensión predeterminada para usar cuando las rutas de imagen / URL no tengan extensión. Esta
le permite utilizar la misma fuente para formatos que requieren diferentes tipos de
imágenes. Actualmente, esta opción solo afecta a los lectores Markdown y LaTeX.
--filter =EJECUTABLE
Especifique un ejecutable que se utilizará como filtro para transformar el AST de pandoc después de la
se analiza la entrada y antes de escribir la salida. El ejecutable debe leer JSON
desde stdin y escriba JSON en stdout. El JSON debe tener el formato propio de pandoc
Entrada y salida JSON. El nombre del formato de salida se pasará al filtro
como primer argumento. Por eso,
pandoc --filter ./caps.py -t látex
es equivalente a
pandoc -t json | ./caps.py latex | pandoc -f json -t látex
La última forma puede resultar útil para depurar filtros.
Los filtros pueden estar escritos en cualquier idioma. Text.Pandoc.JSON exporta aJSONFilter a
Facilitar filtros de escritura en Haskell. Aquellos que prefieren escribir filtros en
python puede usar el módulo pandocfilters, instalable desde PyPI. Tambien hay
Bibliotecas de filtros pandoc en PHP, perl y javascript / node.js.
Tenga en cuenta que EJECUTABLE se buscará en la RUTA del usuario, y no en el trabajo
directorio, si no se proporciona ningún directorio. Si desea ejecutar un script en el trabajo
directorio, preceda el nombre del archivo con./.
-M VENTAJAS[=VAL], --metadata =VENTAJAS[:VAL]
Establecer el campo de metadatos VENTAJAS al valor VAL. Un valor especificado en la línea de comando.
anula un valor especificado en el documento. Los valores se analizarán como booleanos YAML
o valores de cadena. Si no se especifica ningún valor, el valor se tratará como booleano
verdadero. Como --variable, --metadata hace que se establezcan variables de plantilla. Pero a diferencia
--variable, --metadata afecta a los metadatos del documento subyacente (que es
accesible desde filtros y puede imprimirse en algunos formatos de salida).
--normalizar
Normalice el documento después de leerlo: combine elementos Str o Emph adyacentes, para
ejemplo, y elimine los espacios repetidos.
-pag, - preservar-pestañas
Conserva las pestañas en lugar de convertirlas en espacios (predeterminado). Tenga en cuenta que esto
solo afectará a las pestañas en tramos de código literal y bloques de código; pestañas en texto normal
serán tratados como espacios.
--tab-stop =NÚMERO
Especifique el número de espacios por pestaña (el valor predeterminado es 4).
--track-changes = aceptar | rechazar | todos
Especifica qué hacer con las inserciones y eliminaciones producidas por MS Word "Track
Cambia la función. Aceptar (el valor predeterminado), inserta todas las inserciones e ignora todas
eliminaciones. Rechazar inserta todas las eliminaciones e ignora las inserciones. todo pone en ambos
inserciones y eliminaciones, envueltas en tramos con clases de inserción y eliminación,
respectivamente. Se incluye el autor y la hora del cambio. todo es útil para
secuencias de comandos: solo se aceptan cambios de un determinado revisor, por ejemplo, o antes de un determinado
fecha. Esta opción solo afecta al lector de docx.
--extract-media =DIR
Extraiga imágenes y otros medios contenidos en un contenedor docx o epub a la ruta
DIR, creándolo si es necesario, y ajuste las referencias de imágenes en el documento para
apuntan a los archivos extraídos. Esta opción solo afecta a docx y epub.
lectores.
General escritor opciones
-s, --ser único
Producir resultados con un encabezado y pie de página adecuados (por ejemplo, un HTML independiente,
LaTeX, o archivo RTF, no un fragmento). Esta opción se configura automáticamente para pdf,
salida epub, epub3, fb2, docx y odt.
--template =ARCHIVO
Use ARCHIVO como plantilla personalizada para el documento generado. Implica: independiente.
Consulte Plantillas, a continuación, para obtener una descripción de la sintaxis de la plantilla. Si no hay una extensión
especificado, se agregará una extensión correspondiente al escritor, de modo que
--template = busca especial para special.html para salida HTML. Si la plantilla no es
encontrado, pandoc lo buscará en el subdirectorio templates de los datos del usuario
directorio (ver --data-dir). Si no se utiliza esta opción, una plantilla predeterminada
se utilizará el formato de salida apropiado (consulte -D / - print-default-template).
-V VENTAJAS[=VAL], --variable =VENTAJAS[:VAL]
Establecer la variable de plantilla VENTAJAS al valor VAL al renderizar el documento en
modo autónomo. Esto generalmente solo es útil cuando se usa la opción --template
para especificar una plantilla personalizada, ya que pandoc establece automáticamente las variables utilizadas en
las plantillas predeterminadas. Si no VAL se especifica, a la clave se le dará el valor
verdadera.
-D FORMATO, --print-default-template =FORMATO
Imprima la plantilla predeterminada del sistema para una salida FORMATO. (Consulte -t para obtener una lista de
posible FORMATOs.) Se ignoran las plantillas del directorio de datos del usuario.
--print-default-data-file =ARCHIVO
Imprima un archivo de datos predeterminado del sistema. Los archivos del directorio de datos del usuario se ignoran.
--dpi =NÚMERO
Especifique el valor de ppp (puntos por pulgada) para la conversión de píxeles a
pulgadas / centímetros y viceversa. El valor predeterminado es 96 ppp. Técnicamente, el correcto
el término sería ppi (píxeles por pulgada).
--wrap = [auto | none | preserve]
Determine cómo se envuelve el texto en la salida (el código fuente, no el renderizado
versión). Con auto (el predeterminado), pandoc intentará ajustar las líneas a la columna
ancho especificado por --columns (predeterminado 80). Sin ninguno, pandoc no ajustará las líneas.
en absoluto. Con preserve, pandoc intentará preservar el envoltorio del
documento fuente (es decir, donde hay nuevas líneas no semánticas en la fuente, hay
también serán nuevas líneas no semánticas en la salida).
--no envolver
Sinónimo obsoleto para --wrap = none.
--columnas =NÚMERO
Especifique la longitud de las líneas en caracteres (para ajustar el texto). Esto afecta solo al
código fuente generado, no el diseño en la página renderizada.
--toc, --Tabla de contenido
Incluya una tabla de contenido generada automáticamente (o, en el caso del látex,
contexto, y primero, una instrucción para crear uno) en el documento de salida. Esta
La opción no tiene ningún efecto en la salida man, docbook, slidy, slideous, s5, docx u odt.
--toc-depth =NÚMERO
Especifique el número de niveles de sección para incluir en la tabla de contenido. El
el valor predeterminado es 3 (lo que significa que los encabezados de nivel 1, 2 y 3 se enumerarán en el
contenido).
--no resaltar
Deshabilita el resaltado de sintaxis para bloques de código y líneas integradas, incluso cuando un idioma
se da el atributo.
--highlight-style =ESTILO
Especifica el estilo de coloración que se utilizará en el código fuente resaltado. Las opciones son
pigmentos (predeterminado), kate, monocromo, espresso, zenburn, eglefino y tango.
Para obtener más información sobre el resaltado de sintaxis en pandoc, consulte Resaltado de sintaxis,
abajo.
-H ARCHIVO, --include-in-header =ARCHIVO
Incluir contenido de ARCHIVO, literalmente, al final del encabezado. Esto se puede utilizar,
por ejemplo, para incluir CSS especial o javascript en documentos HTML. Esta opción
se puede utilizar repetidamente para incluir varios archivos en el encabezado. Ellos estarán
incluido en el orden especificado. Implica: independiente.
-B ARCHIVO, --include-antes-del-cuerpo =ARCHIVO
Incluir contenido de ARCHIVO, palabra por palabra, al principio del cuerpo del documento (p. ej.
después de la etiqueta en HTML, o el comando \ begin {document} en LaTeX). Esto puede
utilizarse para incluir barras de navegación o banners en documentos HTML. Esta opción puede
utilizarse repetidamente para incluir varios archivos. Estarán incluidos en el pedido.
especificado. Implica: independiente.
-A ARCHIVO, --include-after-body =ARCHIVO
Incluir contenido de ARCHIVO, literalmente, al final del cuerpo del documento (antes del
etiqueta en HTML, o el comando \ end {document} en LaTeX). Esta opción puede ser
utilizarse repetidamente para incluir varios archivos. Estarán incluidos en el pedido.
especificado. Implica: independiente.
Opciónes afectando soluciones y escritores
- autónomo
Produzca un archivo HTML independiente sin dependencias externas, utilizando datos: URI para
incorporar el contenido de scripts, hojas de estilo, imágenes y videos vinculados. El
El archivo resultante debe ser "autónomo", en el sentido de que no necesita
archivos y sin acceso a la red para que un navegador los muestre correctamente. Esta opción funciona
solo con formatos de salida HTML, incluidos html, html5, html + lhs, html5 + lhs, s5,
slidy, slideous, dzslides y reveljs. Guiones, imágenes y hojas de estilo en
se descargarán las URL absolutas; aquellos en URL relativas se buscarán en relación con
el directorio de trabajo (si el primer archivo fuente es local) o relativo a la base
URL (si el primer archivo de origen es remoto). Limitación: recursos que se cargan
dinámicamente a través de JavaScript no se puede incorporar; como resultado,
--autocontenido no funciona con --mathjax, y algunas funciones avanzadas (p. ej.
zoom o notas del orador) puede que no funcionen en una diapositiva "autónoma" de revel.js fuera de línea
espectáculo.
--html-q-etiquetas
Utilice etiquetas para citas en HTML.
--ascii
Utilice solo caracteres ascii en la salida. Actualmente solo se admite para salida HTML
(que usa entidades numéricas en lugar de UTF-8 cuando se selecciona esta opción).
--enlaces de referencia
Utilice enlaces de estilo de referencia, en lugar de enlaces en línea, al escribir Markdown o
reStructuredText. De forma predeterminada, se utilizan enlaces en línea.
--atx-encabezados
Utilice encabezados de estilo ATX en Markdown y salida asciidoc. El valor predeterminado es usar
encabezados de estilo setext para los niveles 1-2, y luego encabezados ATX.
--capítulos
Trate los encabezados de nivel superior como capítulos en la salida LaTeX, ConTeXt y DocBook. Cuándo
la clase de documento LaTeX está configurada para informe, libro o memoria, esta opción está implícita.
Si beamer es el formato de salida, los encabezados de nivel superior se convertirán en \ part {..}.
-NORTE, --numerar-secciones
Numere los títulos de las secciones en la salida LaTeX, ConTeXt, HTML o EPUB. Por defecto,
las secciones no están numeradas. Las secciones con clase sin numerar nunca se numerarán,
incluso si se especifica --number-section.
--number-offset =NÚMERO[,NÚMERO,...]
Desplazamiento para los títulos de las secciones en la salida HTML (ignorado en otros formatos de salida). El
El primer número se agrega al número de sección para los encabezados de nivel superior, el segundo para
encabezados de segundo nivel, etc. Por ejemplo, si desea el primer nivel superior
encabezado en su documento para ser numerado "6", especifique --number-offset = 5. Si tu
el documento comienza con un encabezado de nivel 2 que desea que se numere "1.5", especifique
--number-offset = 1,4. Las compensaciones son 0 por defecto. Implica - número-secciones.
--no-tex-ligaduras
No utilice las ligaduras TeX para comillas, apóstrofos y guiones (`... ',
`` .. '', -, ---) al escribir o leer LaTeX o ConTeXt. Al leer LaTeX, analice
los caracteres `, 'y - literalmente, en lugar de analizar las ligaduras para la cita
marcas y guiones. Al escribir LaTeX o ConTeXt, imprima comillas Unicode y
guión de caracteres literalmente, en lugar de convertirlos al estándar ASCII TeX
ligaduras. Nota: normalmente - inteligente se selecciona automáticamente para LaTeX y ConTeXt
salida, pero debe especificarse explícitamente si se selecciona --no-tex-ligatures. Si
utiliza comillas, guiones y puntos suspensivos literalmente rizados en su fuente, entonces puede
desea utilizar --no-tex-ligatures sin --smart.
--listados
Utilice el paquete de listados para bloques de código LaTeX
-I, - incremental
Hacer que los elementos de la lista en las presentaciones de diapositivas se muestren de forma incremental (uno por uno). El valor predeterminado es
para que las listas se muestren todas a la vez.
--slide-level =NÚMERO
Especifica que los encabezados con el nivel especificado crean diapositivas (para beamer, s5,
resbaladizo, resbaladizo, dzslides). Los encabezados por encima de este nivel en la jerarquía se utilizan para
divida la presentación de diapositivas en secciones; los encabezados por debajo de este nivel crean subtítulos
dentro de una diapositiva. El valor predeterminado es establecer el nivel de diapositiva según el contenido de la
documento; consulte Estructuración de la presentación de diapositivas.
--sección-divs
Envuelva secciones en etiquetas (o etiquetas en HTML5) y adjuntar identificadores a
el cerramiento (o ) en lugar del encabezado en sí. Ver encabezado
identificadores, a continuación.
--email-ofuscation = none | javascript | referencias
Especifique un método para ocultar mailto: enlaces en documentos HTML. ninguno se va
mailto: enlaces tal como están. javascript los ofusca usando javascript.
Las referencias las confunden imprimiendo sus letras como decimales o hexadecimales.
referencias de caracteres. El predeterminado es javascript.
--id-prefix =CADENA
Especifique un prefijo que se agregará a todos los identificadores generados automáticamente en HTML y
Salida de DocBook y números de notas al pie en la salida de Markdown. Esto es útil para
evitando identificadores duplicados al generar fragmentos para ser incluidos en otros
.
-T CADENA, --title-prefix =CADENA
Especificar CADENA como prefijo al principio del título que aparece en el HTML
encabezado (pero no en el título como aparece al principio del cuerpo HTML).
Implica: independiente.
-c Enlance, --css =Enlance
Enlace a una hoja de estilo CSS. Esta opción se puede utilizar repetidamente para incluir
varios archivos. Se incluirán en el orden especificado.
--referencia-odt =ARCHIVO
Utilice el archivo especificado como referencia de estilo al producir una ODT. Para mejores resultados,
la ODT de referencia debe ser una versión modificada de una ODT producida con pandoc.
El contenido de la ODT de referencia se ignora, pero sus hojas de estilo se utilizan en la
nuevo ODT. Si no se especifica ninguna ODT de referencia en la línea de comando, pandoc buscará
para un archivo reference.odt en el directorio de datos del usuario (ver --data-dir). Si esto es
tampoco se encuentra, se utilizarán valores predeterminados sensibles.
--reference-docx =ARCHIVO
Utilice el archivo especificado como referencia de estilo al producir un archivo docx. Para mejor
resultados, el docx de referencia debe ser una versión modificada de un archivo docx producido
usando pandoc. El contenido del docx de referencia se ignora, pero sus hojas de estilo
y se utilizan las propiedades del documento (incluidos los márgenes, el tamaño de la página, el encabezado y el pie de página)
en el nuevo docx. Si no se especifica ningún docx de referencia en la línea de comando, pandoc
buscará un archivo reference.docx en el directorio de datos del usuario (ver --data-dir).
Si tampoco se encuentra, se utilizarán valores predeterminados razonables. Los siguientes estilos
son usados por pandoc: [párrafo] Normal, Cuerpo de texto, Primer párrafo, Compacto, Título,
Subtítulo, Autor, Fecha, Resumen, Bibliografía, Título 1, Título 2, Título 3,
Encabezado 4, Encabezado 5, Encabezado 6, Texto en bloque, Texto de nota al pie, Término de definición,
Definición, leyenda, leyenda de tabla, leyenda de imagen, figura, figura con leyenda, TOC
Título; [carácter] Fuente de párrafo predeterminada, Carácter del texto del cuerpo, Carácter literal,
Referencia de nota al pie, hipervínculo; [tabla] Tabla normal.
--epub-stylesheet =ARCHIVO
Utilice el archivo CSS especificado para diseñar el EPUB. Si no se especifica una hoja de estilo,
pandoc buscará un archivo epub.css en el directorio de datos del usuario (ver --data-dir).
Si no se encuentra allí, se utilizarán valores predeterminados sensibles.
--epub-cover-image =ARCHIVO
Utilice la imagen especificada como portada de EPUB. Se recomienda que la imagen sea
menos de 1000px de ancho y alto. Tenga en cuenta que en un documento fuente de Markdown
también puede especificar una imagen de portada en un bloque de metadatos YAML (consulte Metadatos EPUB, a continuación).
--epub-metadata =ARCHIVO
Busque en el archivo XML especificado los metadatos del EPUB. El archivo debe contener
una serie de elementos Dublin Core. Por ejemplo:
Creative Commons
es-AR
De forma predeterminada, pandoc incluirá los siguientes elementos de metadatos: (desde
el título del documento), (de los autores del documento), (desde el
fecha del documento, que debe estar en formato ISO 8601), (del idioma
variable o, si no se establece, la configuración regional), y (a
UUID generado aleatoriamente). Cualquiera de estos puede ser reemplazado por elementos en el
archivo de metadatos.
Nota: si el documento de origen es Markdown, un bloque de metadatos YAML en el documento puede
ser utilizado en su lugar. Consulte a continuación en Metadatos EPUB.
--epub-embed-font =ARCHIVO
Incruste la fuente especificada en el EPUB. Esta opción se puede repetir para incrustar
múltiples fuentes. También se pueden utilizar comodines: por ejemplo, DejaVuSans - *. Ttf.
Sin embargo, si usa comodines en la línea de comando, asegúrese de escapar de ellos o poner
el nombre del archivo completo entre comillas simples, para evitar que el
cáscara. Para usar las fuentes incrustadas, deberá agregar declaraciones como la
siguiendo a su CSS (ver --epub-stylesheet):
@Perfil delantero {
familia de fuentes: DejaVuSans;
estilo de fuente: normal;
fuente-peso: normal;
src: url ("DejaVuSans-Regular.ttf");
}
@Perfil delantero {
familia de fuentes: DejaVuSans;
estilo de fuente: normal;
font-weight: bold;
src: url ("DejaVuSans-Bold.ttf");
}
@Perfil delantero {
familia de fuentes: DejaVuSans;
estilo de fuente: cursiva;
fuente-peso: normal;
src: url ("DejaVuSans-Oblique.ttf");
}
@Perfil delantero {
familia de fuentes: DejaVuSans;
estilo de fuente: cursiva;
font-weight: bold;
src: url ("DejaVuSans-BoldOblique.ttf");
}
body {font-family: "DejaVuSans"; }
--epub-chapter-level =NÚMERO
Especifique el nivel de encabezado en el que dividir el EPUB en archivos de "capítulos" separados.
El valor predeterminado es dividir en capítulos en los encabezados de nivel 1. Esta opción solo afecta
la composición interna del EPUB, no la forma en que los capítulos y secciones son
mostrado a los usuarios. Algunos lectores pueden ser lentos si los archivos de capítulos son demasiado grandes,
por lo que para documentos grandes con pocos encabezados de nivel 1, es posible que desee utilizar un capítulo
nivel de 2 o 3.
--latex-motor = pdflatex | lualatex | xelatex
Utilice el motor LaTeX especificado al producir una salida PDF. El valor predeterminado es pdflatex.
Si el motor no está en su RUTA, se puede especificar la ruta completa del motor
--latex-engine-opt =CADENA
Utilice la cadena dada como argumento de línea de comandos para el motor de látex. Si se usa
varias veces, los argumentos se proporcionan con espacios entre ellos. Tenga en cuenta que no
Se ha realizado la comprobación de opciones duplicadas.
Citación representación
--bibliografía =ARCHIVO
Establezca el campo de bibliografía en los metadatos del documento en ARCHIVO, anulando cualquier valor
establecido en los metadatos y procesa las citas usando pandoc-citeproc. (Esto es
equivalente a --metadata bibliography = FILE --filter pandoc-citeproc.) Si --natbib
o --biblatex también se suministra, pandoc-citeproc no se usa, lo que hace que este sea equivalente
a - bibliografía de metadatos = ARCHIVO. Si proporciona este argumento varias veces, cada
ARCHIVO se agregará a la bibliografía.
--csl =ARCHIVO
Establezca el campo csl en los metadatos del documento en ARCHIVO, anulando cualquier valor establecido en
los metadatos. (Esto es equivalente a --metadata csl = FILE.) Esta opción es solo
relevante con pandoc-citeproc.
--citation-abbreviations =ARCHIVO
Establezca el campo de abreviaturas de citas en los metadatos del documento en ARCHIVO, anulando
cualquier valor establecido en los metadatos. (Esto es equivalente a
--metadata citation-abbreviations = FILE.) Esta opción solo es relevante con
pandoc-citeproc.
--natbib
Utilice natbib para las citas en la salida LaTeX. Esta opción no es para usar con el
filtro pandoc-citeproc o con salida PDF. Está diseñado para su uso en la producción de
Archivo LaTeX que se puede procesar con bibtex.
--biblatex
Utilice biblatex para las citas en la salida LaTeX. Esta opción no es para usar con el
filtro pandoc-citeproc o con salida PDF. Está diseñado para su uso en la producción de
Archivo LaTeX que se puede procesar con bibtex o biber.
Matemáticas representación in HTML
-m [Enlance], --latexmathml [=Enlance]
Utilice LaTeXMathML para mostrar matemáticas TeX incrustadas en la salida HTML. El Enlance debería señalar
al script de carga LaTeXMathML.js. Si un Enlance no se proporciona, un enlace a
Se insertará LaTeXMathML.js en la página de inicio de LaTeXMathML.
--mathml [=Enlance]
Convierta las matemáticas TeX a MathML (en docbook, así como en html y html5). En autónomo
salida html, un pequeño javascript (o un enlace a dicho script si un Enlance es proporcionado)
Se insertará que permite que MathML se vea en algunos navegadores.
--jsmath [=Enlance]
Utilice jsMath para mostrar matemáticas TeX incrustadas en la salida HTML. El Enlance debería apuntar a
el script de carga jsMath (por ejemplo, jsMath / easy / load.js); si se proporciona, se vinculará
a en el encabezado de los documentos HTML independientes. Si un Enlance no se proporciona, no hay enlace
en el script de carga jsMath se insertará; entonces depende del autor proporcionar
dicho enlace en la plantilla HTML.
--mathjax [=Enlance]
Utilice MathJax para mostrar matemáticas TeX incrustadas en la salida HTML. El Enlance debería apuntar a
el script de carga MathJax.js. Si un Enlance no se proporciona, un enlace a MathJax CDN
se insertará.
--gladtex
Incluya matemáticas TeX en etiquetas en la salida HTML. Estos luego pueden ser procesados por
gladTeX para producir enlaces a imágenes de las fórmulas compuestas.
--mimetex [=Enlance]
Renderice las matemáticas de TeX usando el script CGI de mimeTeX. Si Enlance no se especifica, es
asumió que el script está en /cgi-bin/mimetex.cgi.
--webtex [=Enlance]
Renderice fórmulas TeX usando un script externo que convierta fórmulas TeX en imágenes.
La fórmula se concatenará con la URL proporcionada. Si Enlance no está especificado,
se utilizará la API de Google Chart.
--katex [=Enlance]
Utilice KaTeX para mostrar matemáticas TeX incrustadas en la salida HTML. El Enlance debe apuntar al
katex.js carga el script. Si un Enlance no se proporciona, un enlace a KaTeX CDN será
insertado.
--katex-stylesheet =Enlance
Los Enlance debe apuntar a la hoja de estilo katex.css. Si no se especifica esta opción,
Se insertará un enlace a KaTeX CDN. Tenga en cuenta que esta opción no implica
--katex.
Opciónes for envoltura guiones
--dump-argumentos
Imprime información sobre los argumentos de la línea de comandos para stdout, luego sal. Esta opción
está diseñado principalmente para su uso en scripts de contenedor. La primera línea de salida
contiene el nombre del archivo de salida especificado con la opción -o, o - (para
stdout) si no se especificó ningún archivo de salida. Las líneas restantes contienen el
argumentos de la línea de comandos, uno por línea, en el orden en que aparecen. Estos no
incluir opciones de pandoc regulares y sus argumentos, pero incluir cualquier opción
que aparece después de un - separador al final de la línea.
--ignorar argumentos
Ignore los argumentos de la línea de comandos (para usar en scripts de envoltura). Opciones regulares de pandoc
no se ignoran. Así, por ejemplo,
pandoc --ignore-args -o foo.html -s foo.txt - -e latin1
es equivalente a
pandoc -o foo.html -s
TEMPLATES
Cuando se usa la opción -s / - independiente, pandoc usa una plantilla para agregar encabezado y pie de página
material que se necesita para un documento autónomo. Para ver la plantilla predeterminada que es
usado, solo escribe
pandoc -D * FORMATO *
donde FORMATO es el nombre del formato de salida. Se puede especificar una plantilla personalizada usando
la opción --template. También puede anular las plantillas predeterminadas del sistema para un determinado
formato de salida FORMATO poniendo un archivo templates / default. * FORMAT * en los datos del usuario
directorio (ver --data-dir, arriba). Excepciones: Para la salida odt, personalice el
plantilla de documento predeterminada. Para la salida en pdf, personalice la plantilla default.latex.
Las plantillas contienen las variables, que permiten la inclusión de información arbitraria en cualquier
apuntar en el archivo. Las variables se pueden establecer dentro del documento utilizando bloques de metadatos YAML.
También se pueden configurar en la línea de comando usando la opción -V / - variable: variables establecidas en
de esta forma anula los campos de metadatos con el mismo nombre.
Variables para reinventar la industria logística y redefinir las soluciones ecológicas para reinventar la industria logística y redefinir las soluciones ecológicas. by pandoc
Pandoc establece automáticamente algunas variables. Estos varían un poco dependiendo de la
formato de salida, pero incluye campos de metadatos, así como lo siguiente:
título, autor, datos
Permitir la identificación de aspectos básicos del documento. Incluido en metadatos PDF
a través de LaTeX y ConTeXt. Estos se pueden configurar a través de un bloque de título de pandoc, que
permite múltiples autores, o mediante un bloque de metadatos YAML:
. . .
autor:
- Aristóteles
- Pedro Abelardo
...
subtítulo
subtítulo del documento, incluido en HTML, EPUB, LaTeX, ConTeXt y Word docx; renders
en LaTeX solo cuando se usa una clase de documento que admita \ subtítulo, como beamer
o la serie KOMA-Script (scrartcl, scrreprt, scrbook).
resumen
resumen del documento, incluido en LaTeX, ConTeXt, AsciiDoc y Word docx
las palabras claves
lista de palabras clave que se incluirán en metadatos HTML, PDF y AsciiDoc; quizás
repetido como para el autor, arriba
encabezado-incluye
contenido especificado por -H / - include-in-header (puede tener varios valores)
toc valor no nulo si se especificó --toc / - tabla de contenido
toc-título
título de la tabla de contenido (funciona solo con EPUB y docx)
incluir antes
contenido especificado por -B / - include-before-body (puede tener varios valores)
incluir-después
contenido especificado por -A / - include-after-body (puede tener varios valores)
cuerpo cuerpo del documento
meta-json
Representación JSON de todos los metadatos del documento.
Idioma las variables
lang identifica el idioma principal del documento, utilizando un código según BCP 47
(por ejemplo, en o en-GB). Para algunos formatos de salida, pandoc lo convertirá a un
formato apropiado almacenado en las variables adicionales babel-lang, polyglossia-lang
(LaTeX) y context-lang (ConTeXt).
Se pueden usar spans y divs nativos de pandoc con el atributo lang (valor en BCP 47)
para cambiar el idioma en ese rango.
otras lenguas
una lista de otros idiomas utilizados en el documento en los metadatos YAML, según
BCP 47. Por ejemplo: otherlangs: [en-GB, fr]. Esto se genera automáticamente
de los atributos lang en todos los intervalos y divs, pero se pueden anular. En la actualidad
sólo utilizado por LaTeX a través de los babel-otherlangs generados y
variables de poliglosia-otras lenguas. El escritor LaTeX genera comandos de poliglosia en
el texto, pero la variable babel-newcommands contiene asignaciones para ellos al
correspondiente babel.
dir la dirección base del documento, ya sea rtl (de derecha a izquierda) o ltr
(de izquierda a derecha).
Para documentos bidireccionales, divisiones y divs nativos de pandoc con el atributo dir
(valor rtl o ltr) se puede usar para anular la dirección base en alguna salida
formatos. Esto puede no ser siempre necesario si el renderizador final (por ejemplo, el
navegador, al generar HTML) admite el algoritmo bidireccional Unicode.
Cuando se usa LaTeX para documentos bidireccionales, solo el motor xelatex está completamente
soportado (use --latex-engine = xelatex).
Variables for diapositivas
Las variables están disponibles para producir presentaciones de diapositivas con pandoc, incluidas todas las revelaciones.js
opciones de configuración.
URL deslizable
URL base para documentos Slidy (predeterminado en http://www.w3.org/Talks/Tools/Slidy2)
URL deslizante
URL base para documentos Slideous (por defecto es slideous)
URL s5 URL base para documentos S5 (predeterminado en s5 / predeterminado)
reveljs-url
URL base para los documentos de revel.js (por defecto, revel.js)
tema, tema de color, tema de fuente, innertheme nuestro tema
temas para documentos LaTeX beamer
navegación
controla los símbolos de navegación en los documentos de beamer (el valor predeterminado es vacío para no navegar
símbolos otros valores válidos son frame, vertical y horizontal).
títulos de sección
habilita en "páginas de título" para nuevas secciones en documentos beamer (predeterminado = verdadero).
Variables for Látex
Las variables LaTeX se utilizan al crear un PDF.
Tamaño de papel
tamaño de papel, por ejemplo, carta, A4
tamaño de fuente
tamaño de fuente para el texto del cuerpo (por ejemplo, 10pt, 12pt)
clase de documento
clase de documento, por ejemplo, artículo, informe, libro, memoria
opción de clase
opción para la clase de documento, por ejemplo, un lado; puede repetirse para múltiples opciones
geometría
opción para el paquete de geometría, por ejemplo, margin = 1in; puede repetirse para múltiples opciones
margen izquierdo, margen derecho, margen superior, margen inferior
establece márgenes, si no se utiliza la geometría (de lo contrario, la geometría los anula)
estiramiento
ajusta el espaciado de línea usando el paquete setspace, por ejemplo, 1.25, 1.5
Familia tipográfica
paquete de fuentes para usar con pdflatex: TeX Live incluye muchas opciones, documentadas en
el Catálogo de fuentes LaTeX. El valor predeterminado es Latin Modern.
opciones de la familia de fuentes
opciones para el paquete utilizado como fontfamily: por ejemplo, osf, sc con fontfamily establecido en
mathpazo proporciona a Palatino cifras de estilo antiguo y versalitas verdaderas; tal vez
repetido para múltiples opciones
fuente principal, sansfont, monofonte fuente matemática, Fuente principal CJK
familias de fuentes para usar con xelatex o lualatex: tome el nombre de cualquier fuente del sistema,
usando el paquete fontspec. Tenga en cuenta que si se utiliza CJKmainfont, el paquete xecjk
debe estar disponible.
opciones de fuente principal, sansfontoptions, monofontopciones, Mathfontoptions, CJKopciones
opciones para usar con mainfont, sansfont, monofont, mathfont, CJKmainfont en xelatex
y lualatex. Permita las opciones disponibles a través de fontspec, como el
Características de OpenType: Numbers = OldStyle, Numbers = Proporcional. Puede repetirse por
múltiples opciones.
fuente
permite especificar la codificación de fuentes a través del paquete fontenc (con pdflatex);
el valor predeterminado es T1 (consulte la guía de codificaciones de fuentes LaTeX)
enlaces de color
agregue color al texto del enlace; habilitado automáticamente si alguno de linkcolor, citecolor,
urlcolor o toccolor están configurados
Color de enlace, citacolor, color de URL, tocolor
color para enlaces internos, enlaces de citas, enlaces externos y enlaces en la tabla de
contenido: utiliza cualquiera de los colores LaTeX predefinidos
enlaces como notas
hace que los enlaces se impriman como notas a pie de página
sangrar utiliza la configuración de la clase de documento para la sangría (la plantilla LaTeX predeterminada de lo contrario
elimina la sangría y agrega espacio entre párrafos)
subpárrafo
deshabilita el comportamiento predeterminado de la plantilla LaTeX que redefine (sub) párrafos como
secciones, cambiando la apariencia de los encabezados anidados en algunas clases
gracias especifica el contenido de la nota a pie de página de agradecimientos después del título del documento.
toc incluir tabla de contenido (también se puede configurar usando --toc / - tabla de contenido)
TOC-profundidad
nivel de sección para incluir en la tabla de contenido
lof montón
incluir lista de figuras, lista de tablas
bibliografía
bibliografía a utilizar para resolver referencias
estilo biblio
estilo de bibliografía, cuando se usa con --natbib y --biblatex.
biblatexopciones
lista de opciones para biblatex.
Variables for Contexto
Tamaño de papel
tamaño de papel, por ejemplo, carta, A4, paisaje (consulte Configuración de papel de ConTeXt); puede repetirse
para múltiples opciones
diseño opciones para los márgenes de la página y la disposición del texto (ver Diseño de ConTeXt); puede repetirse
para múltiples opciones
margen izquierdo, margen derecho, margen superior, margen inferior
establece márgenes, si no se utiliza el diseño (de lo contrario, el diseño los anula)
tamaño de fuente
tamaño de fuente para el texto del cuerpo (por ejemplo, 10pt, 12pt)
fuente principal, sansfont, monofonte Mathfont
familias de fuentes: tome el nombre de cualquier fuente del sistema (consulte Cambio de fuente de ConTeXt)
Color de enlace, color de contraste
color para enlaces fuera y dentro de una página, por ejemplo, rojo, azul (ver Color de ConTeXt)
estilo de enlace
estilo de letra para los enlaces, por ejemplo, normal, negrita, inclinada, negrita inclinada, tipo, mayúscula,
chica
sangría
controla la sangría de los párrafos, por ejemplo, sí, pequeño, siguiente (ver Sangría de ConTeXt);
puede repetirse para múltiples opciones
espacio en blanco
espaciado entre párrafos, por ejemplo, ninguno, pequeño (usando setupwhitespace)
interlínea
ajusta el espaciado de línea, por ejemplo, 4ex (usando setupinterlinespace); puede repetirse por
múltiples opciones
texto de cabecera, texto de pie de página
texto que se colocará en el encabezado o pie de página en ejecución (consulte Encabezados y pies de página de ConTeXt);
se puede repetir hasta cuatro veces para diferentes ubicaciones
numeración de páginas
estilo y ubicación del número de página (usando setuppagenumbering); puede repetirse por
múltiples opciones
toc incluir tabla de contenido (también se puede configurar usando --toc / - tabla de contenido)
lof montón
incluir lista de figuras, lista de tablas
Variables for hombre paginas
.
número de sección en las páginas del manual
encabezamiento encabezado en las páginas del manual
pie de página pie de página en las páginas del manual
el ajuste
ajusta el texto a los márgenes izquierdo (l), derecho (r), central (c) o ambos (b)
escribir con guión
si es verdadero (el valor predeterminado), se usarán guiones
Gracias a las variables in templates
Los nombres de las variables son secuencias de caracteres alfanuméricos, - y _, que comienzan con una letra. A
El nombre de la variable rodeado por signos $ será reemplazado por su valor. Por ejemplo, el
cadena $ título $ en
$ título $
será reemplazado por el título del documento.
Para escribir un $ literal en una plantilla, use $$.
Las plantillas pueden contener condicionales. La sintaxis es la siguiente:
$ si (variable) $
X
$ else $
Y
$ endif $
Esto incluirá X en la plantilla si la variable tiene un valor no nulo; de lo contrario lo hará
incluir Y. X e Y son marcadores de posición para cualquier texto de plantilla válido y pueden incluir
variables interpoladas u otros condicionales. La sección $ else $ puede omitirse.
Cuando las variables pueden tener varios valores (por ejemplo, autor en un documento de varios autores),
puede usar la palabra clave $ por $:
$ para (autor) $
$ endfor $
Opcionalmente, puede especificar un separador para usar entre elementos consecutivos:
$ para (autor) $$ autor $$ sep $, $ endfor $
Se puede usar un punto para seleccionar un campo de una variable que toma un objeto como su valor. Entonces,
por ejemplo:
$ author.name $ ($ author.affiliation $)
Si usa plantillas personalizadas, es posible que deba revisarlas a medida que pandoc cambie. Nosotros recomendamos
realizar un seguimiento de los cambios en las plantillas predeterminadas y modificar sus plantillas personalizadas
respectivamente. Una manera fácil de hacer esto es bifurcar el repositorio pandoc-templates y fusionar
en cambios después de cada lanzamiento de pandoc.
PANDOC'S MARKDOWN
Pandoc comprende una versión ampliada y ligeramente revisada de Markdown de John Gruber
sintaxis. Este documento explica la sintaxis y señala las diferencias con el Markdown estándar.
Excepto donde se indique, estas diferencias se pueden suprimir mediante el uso de markdown_strict
formato en lugar de rebajas. Se pueden habilitar extensiones agregando + EXTENSION al
nombre del formato y deshabilitado agregando -EXTENSION. Por ejemplo, markdown_strict + footnotes es
Markdown estricto con notas al pie habilitadas, mientras que markdown-footnotes-pipe_tables es de pandoc
Rebajas sin notas a pie de página ni tablas de tuberías.
Filosofía
Markdown está diseñado para que sea fácil de escribir y, lo que es más importante, fácil de leer:
Un documento con formato Markdown debe poder publicarse tal cual, como texto sin formato, sin
parece que se ha marcado con etiquetas o instrucciones de formato. -- John
Gruber
Este principio ha guiado las decisiones de pandoc en la búsqueda de sintaxis para tablas, notas al pie y
otras extensiones.
Sin embargo, hay un aspecto en el que los objetivos de pandoc son diferentes de los objetivos originales.
de Markdown. Mientras que Markdown se diseñó originalmente teniendo en cuenta la generación de HTML,
pandoc está diseñado para múltiples formatos de salida. Así, mientras pandoc permite la incrustación
de HTML sin formato, lo desalienta y proporciona otras formas de representar
elementos importantes del documento como listas de definiciones, tablas, matemáticas y notas al pie.
Párrafos
Un párrafo es una o más líneas de texto seguidas de una o más líneas en blanco. Newlines
se tratan como espacios, por lo que puede ajustar los párrafos a su gusto. Si necesitas un duro
salto de línea, ponga dos o más espacios al final de una línea.
Extensión: escape_line_breaks
Una barra invertida seguida de una nueva línea también es un salto de línea duro. Nota: en multilínea y cuadrícula
celdas de tabla, esta es la única forma de crear un salto de línea duro, ya que los espacios finales en
las celdas se ignoran.
Cabezales
Hay dos tipos de encabezados: Setext y ATX.
Estilo de texto cabeceras
Un encabezado de estilo setext es una línea de texto "subrayado" con una fila de signos = (para un nivel
un encabezado) o - signos (para un encabezado de nivel dos):
Un encabezado de nivel uno
==================
Un encabezado de nivel dos
------------------
El texto del encabezado puede contener formato en línea, como énfasis (consulte Formato en línea,
abajo).
Estilo ATX cabeceras
Un encabezado de estilo ATX consta de uno a seis signos # y una línea de texto, opcionalmente seguidos
por cualquier número de signos #. El número de signos # al principio de la línea es el
nivel de encabezado:
## Un encabezado de nivel dos
### Un encabezado de nivel tres ###
Al igual que con los encabezados de estilo setext, el texto del encabezado puede contener formato:
# Un encabezado de nivel uno con un [enlace] (/ url) y * énfasis *
Extensión: encabezado_en_blanco_antes_del_encabezado
La sintaxis estándar de Markdown no requiere una línea en blanco antes de un encabezado. Pandoc hace
requiera esto (excepto, por supuesto, al principio del documento). El motivo de la
El requisito es que es demasiado fácil que un # termine al principio de una línea
accidente (tal vez a través del ajuste de línea). Considere, por ejemplo:
Me gustan varios de sus sabores de helado:
# 22, por ejemplo, y # 5.
Encabezamiento Identificadores
Extensión: atributos_del_encabezado
A los encabezados se les pueden asignar atributos usando esta sintaxis al final de la línea que contiene el
texto de cabecera:
{#identifier .class .class clave = valor clave = valor}
Así, por ejemplo, a los siguientes encabezados se les asignará el identificador foo:
# Mi encabezado {#foo}
## Mi encabezado ## {#foo}
Mi otro encabezado {#foo}
---------------
(Esta sintaxis es compatible con PHP Markdown Extra).
Tenga en cuenta que aunque esta sintaxis permite la asignación de clases y atributos clave / valor,
los escritores generalmente no usan toda esta información. Identificadores, clases y clave / valor
Los atributos se utilizan en HTML y formatos basados en HTML como EPUB y slidy. Identificadores
se utilizan para etiquetas y anclajes de enlaces en los escritores LaTeX, ConTeXt, Textile y AsciiDoc.
Los encabezados con la clase sin numerar no se numerarán, incluso si --number-section es
especificado. Un solo guión (-) en un contexto de atributo equivale a .unnumbered, y
preferible en documentos que no estén en inglés. Entonces,
# Mi encabezado {-}
es lo mismo que
# Mi encabezado {.unnumbered}
Extensión: auto_identificadores
A un encabezado sin un identificador especificado explícitamente se le asignará automáticamente un
identificador único basado en el texto del encabezado. Para derivar el identificador del encabezado
texto,
· Eliminar todo formato, enlaces, etc.
· Quite todas las notas a pie de página.
· Elimine toda la puntuación, excepto los guiones bajos, guiones y puntos.
· Reemplaza todos los espacios y nuevas líneas con guiones.
· Convierte todos los caracteres alfabéticos a minúsculas.
· Elimine todo hasta la primera letra (los identificadores no pueden comenzar con un número o
signo de puntuación).
· Si no queda nada después de esto, use la sección de identificador.
Así, por ejemplo,
Identificador de encabezado
────────────────────────────────────────────────── ──────
Identificadores de encabezado en HTML header-identifiers-in-html
* ¿Perros *? - ¿En * mi * casa? perros - en-mi-casa
[HTML], [S5] o [RTF]? html-s5-o-rtf
3. Aplicaciones aplicaciones
Sección 33
Estas reglas deberían, en la mayoría de los casos, permitir que uno determine el identificador del encabezado
texto. La excepción es cuando varios encabezados tienen el mismo texto; en este caso, el primero
obtendrá un identificador como se describe arriba; el segundo obtendrá el mismo identificador con -1
adjunto el tercero con -2; y así.
Estos identificadores se utilizan para proporcionar destinos de enlace en la tabla de contenido generada por
la opción --toc | --table-of-contents. También facilitan el suministro de enlaces desde una
sección de un documento a otro. Un enlace a esta sección, por ejemplo, podría verse como
modo:
Vea la sección sobre
[identificadores de encabezado] (# identificadores de encabezado-en-html-latex-and-context).
Sin embargo, tenga en cuenta que este método de proporcionar enlaces a secciones solo funciona en HTML, LaTeX,
y formatos ConTeXt.
Si se especifica la opción --section-divs, entonces cada sección se incluirá en un div (o
una sección, si se especificó --html5), y el identificador se adjuntará al
(o ) etiqueta en lugar del encabezado en sí. Esto permite que secciones enteras sean
manipulado usando javascript o tratado de manera diferente en CSS.
Extensión: referencias_cabecera_implícitas
Pandoc se comporta como si se hubieran definido enlaces de referencia para cada encabezado. Entonces, en lugar de
[identificadores de encabezado] (# identificadores de encabezado-en-html)
simplemente puedes escribir
[identificadores de encabezado]
or
[identificadores de encabezado] []
or
[la sección sobre identificadores de encabezado] [identificadores de encabezado]
Si hay varios encabezados con texto idéntico, se vinculará la referencia correspondiente
solo al primero, y deberá utilizar enlaces explícitos para enlazar con los demás, ya que
descrito arriba.
Al igual que los enlaces de referencia habituales, estas referencias no distinguen entre mayúsculas y minúsculas.
Las definiciones de referencia de enlace explícitas siempre tienen prioridad sobre las referencias de encabezado implícitas.
Entonces, en el siguiente ejemplo, el enlace apuntará a la barra, no a #foo:
#foo
[foo]: barra
Ver [foo]
Bloquear citas
Markdown utiliza convenciones de correo electrónico para citar bloques de texto. Una cita en bloque es una o
más párrafos u otros elementos de bloque (como listas o encabezados), con cada línea
precedido por un carácter> y un espacio opcional. (No es necesario que comience por la izquierda
margen, pero no debe tener más de tres espacios de sangría.)
> Esta es una cotización en bloque. Esta
> párrafo tiene dos líneas.
>
> 1. Esta es una lista dentro de una cita en bloque.
> 2. Segundo elemento.
Una forma "perezosa", que requiere el carácter> solo en la primera línea de cada bloque, es
también permitido:
> Esta es una cotización en bloque. Esta
El párrafo tiene dos líneas.
> 1. Esta es una lista dentro de una cita en bloque.
2. Segundo artículo.
Entre los elementos de bloque que pueden estar contenidos en una cita de bloque se encuentran otras citas de bloque.
Es decir, las comillas en bloque se pueden anidar:
> Esta es una cotización en bloque.
>
>> Una cita en bloque dentro de una cita en bloque.
Si el carácter> va seguido de un espacio opcional, ese espacio se considerará parte de
el marcador de comillas en bloque y no forma parte de la sangría del contenido. Por lo tanto, para poner un
bloque de código sangrado en una cita de bloque, necesita cinco espacios después de>:
> código
Extensión: cita_en_blanco_antes_del_bloque
La sintaxis estándar de Markdown no requiere una línea en blanco antes de una cotización en bloque. Pandoc hace
requiera esto (excepto, por supuesto, al principio del documento). El motivo de la
El requisito es que es demasiado fácil para un> terminar al principio de una línea
accidente (tal vez a través del ajuste de línea). Entonces, a menos que se use el formato markdown_strict,
lo siguiente no produce una cita de bloque anidado en pandoc:
> Esta es una cotización en bloque.
>> Anidado.
Literal (código) bloques
Sangrado código bloques
Un bloque de texto con sangría de cuatro espacios (o una pestaña) se trata como texto literal: es decir,
los caracteres especiales no activan un formato especial, y todos los espacios y saltos de línea son
Preservado. Por ejemplo,
si (a> 3) {
moveShip (5 * gravedad, ABAJO);
}
La sangría inicial (cuatro espacios o una pestaña) no se considera parte de la palabra palabra por palabra.
texto y se elimina en la salida.
Nota: las líneas en blanco en el texto literal no necesitan comenzar con cuatro espacios.
Cercado código bloques
Extensión: bloques de código vallado
Además de los bloques de código con sangría estándar, pandoc admite cercado bloques de código. Estos
comenzar con una fila de tres o más tildes (~) y terminar con una fila de tildes que deben estar en
al menos tan largo como la fila inicial. Todo entre estas líneas se trata como código. No
la sangría es necesaria:
~~~~~~~
si (a> 3) {
moveShip (5 * gravedad, ABAJO);
}
~~~~~~~
Al igual que los bloques de código normales, los bloques de código delimitados deben estar separados del texto circundante por
líneas en blanco.
Si el código en sí contiene una fila de tildes o comillas invertidas, simplemente use una fila más larga de tildes
o comillas invertidas al principio y al final:
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~~~~~~~~~~
código que incluye tildes
~~~~~~~~~~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
Extensión: backtick_code_blocks
Igual que fenced_code_blocks, pero usa comillas invertidas (`) en lugar de tildes (~).
Extensión: Atributos_de_código_cercado
Opcionalmente, puede adjuntar atributos al bloque de código delimitado o con tilde invertido utilizando esta sintaxis:
~~~~ {#mycode .haskell .numberLines startFrom = "100"}
qclasificar [] = []
qsort (x: xs) = qsort (filtro (<x) xs) ++ [x] ++
qsort (filtro (> = x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Aquí mycode es un identificador, haskell y numberLines son clases y startFrom es un
atributo con valor 100. Algunos formatos de salida pueden utilizar esta información para realizar la sintaxis
destacando. Actualmente, los únicos formatos de salida que utilizan esta información son HTML y
Látex. Si el resaltado es compatible con su formato e idioma de salida, entonces el código
El bloque de arriba aparecerá resaltado, con líneas numeradas. (Para ver qué idiomas son
compatible, haga pandoc --version.) De lo contrario, el bloque de código de arriba aparecerá de la siguiente manera:
...
También se puede utilizar un formulario de acceso directo para especificar el idioma del bloque de código:
`` haskell
qclasificar [] = []
`` `
Esto es equivalente a:
`` `{.haskell}
qclasificar [] = []
`` `
Si la extensión fenced_code_attributes está deshabilitada, pero la entrada contiene atributos de clase
para el bloque de código, el atributo de primera clase se imprimirá después de la valla de apertura como un
palabra desnuda.
Para evitar todo resaltado, use la bandera --no-highlight. Para establecer el estilo de resaltado,
use - estilo de resaltado. Para obtener más información sobre el resaltado, consulte Resaltado de sintaxis,
abajo.
Line bloques
Extensión: bloques_de_línea
Un bloque de línea es una secuencia de líneas que comienza con una barra vertical (|) seguida de un espacio.
La división en líneas se conservará en la salida, al igual que los espacios iniciales;
de lo contrario, las líneas se formatearán como Markdown. Esto es útil para verso y
direcciones:
| Los packs de limerick se ríen anatómicos
| En el espacio eso es bastante económico.
| Pero los buenos que he visto
| Tan pocas veces están limpias
| Y los limpios rara vez son cómicos
| 200 calle principal
| Berkeley, CA 94718
Las líneas se pueden ajustar si es necesario, pero la línea de continuación debe comenzar con un
espacio.
| El Muy Honorable, Venerable y Justo Samuel L.
Condestable, Jr.
| 200 calle principal
| Berkeley, CA 94718
Esta sintaxis se tomó prestada de reStructuredText.
Listas
Bullet liza
Una lista con viñetas es una lista de elementos de lista con viñetas. Un elemento de lista con viñetas comienza con una viñeta
(*, + o -). A continuación, se muestra un ejemplo sencillo:
* una
* dos
* Tres
Esto producirá una lista "compacta". Si desea una lista "suelta", en la que cada elemento es
formateado como un párrafo, ponga espacios entre los elementos:
* una
* dos
* Tres
No es necesario que las viñetas estén alineadas con el margen izquierdo; pueden tener sangría de uno, dos o
tres espacios. La viñeta debe ir seguida de un espacio en blanco.
Los elementos de la lista se ven mejor si las líneas siguientes están alineadas con la primera línea (después de la viñeta):
* aquí está mi primero
elemento de lista.
* y mi segundo.
Pero Markdown también permite un formato "perezoso":
* aquí está mi primero
elemento de lista.
* y mi segundo.
Los cuatro espacios gobernar
Un elemento de lista puede contener varios párrafos y otro contenido a nivel de bloque. Sin embargo,
los párrafos subsiguientes deben ir precedidos de una línea en blanco y cuatro espacios o una tabulación con sangría.
La lista se verá mejor si el primer párrafo está alineado con el resto:
* Primer párrafo.
Continuado.
* Segundo parrafo. Con un bloque de código, que debe estar sangrado
ocho espacios:
{código}
Los elementos de la lista pueden incluir otras listas. En este caso, la línea en blanco anterior es opcional.
La lista anidada debe tener una sangría de cuatro espacios o una pestaña:
* frutas
+ manzanas
- macintosh
- rojo delicioso
+ peras
+ melocotones
* vegetales
+ brócoli
+ acelga
Como se señaló anteriormente, Markdown le permite escribir elementos de la lista "perezosamente", en lugar de sangrar
líneas de continuación. Sin embargo, si hay varios párrafos u otros bloques en una lista
elemento, la primera línea de cada uno debe tener sangría.
+ Una lista perezosa, perezosa
ít.
+ Otro; esto se ve
mal pero es legal.
Segundo párrafo del segundo
elemento de lista.
Nota: Aunque la regla de los cuatro espacios para los párrafos de continuación proviene del
La guía de sintaxis de Markdown, la implementación de referencia, Markdown.pl, no la sigue. Entonces
pandoc dará resultados diferentes a Markdown.pl cuando los autores hayan sangrado
párrafos de continuación con menos de cuatro espacios.
La guía de sintaxis de Markdown no es explícita si la regla de los cuatro espacios se aplica a all
contenido a nivel de bloque en un elemento de lista; solo menciona párrafos y bloques de código. Pero
implica que la regla se aplica a todo el contenido a nivel de bloque (incluidas las listas anidadas), y
pandoc lo interpreta de esa manera.
Ordenado liza
Las listas ordenadas funcionan igual que las listas con viñetas, excepto que los elementos comienzan con enumeradores
en lugar de balas.
En Markdown estándar, los enumeradores son números decimales seguidos de un punto y un espacio.
Los números en sí mismos se ignoran, por lo que no hay diferencia entre esta lista:
1. uno
2. dos
3. tres
y éste:
5. uno
7. dos
1. tres
Extensión: listas_de_fancy
A diferencia de Markdown estándar, pandoc permite que los elementos de la lista ordenados se marquen con mayúsculas y
letras minúsculas y números romanos, además de números arábigos. Los marcadores de lista pueden ser
entre paréntesis o seguido de un solo paréntesis a la derecha o un punto. Ellos deben ser
separados del texto que sigue por al menos un espacio, y, si el marcador de lista es un
letra mayúscula con punto, de al menos dos espacios.
La extensión fancy_lists también permite usar '#' como un marcador de lista ordenada en lugar de
un numeral:
#. una
#. dos
Extensión: número de inicio
Pandoc también presta atención al tipo de marcador de lista utilizado y al número inicial,
y ambos se conservan siempre que sea posible en el formato de salida. Por lo tanto, lo siguiente
produce una lista con números seguidos de un solo paréntesis, comenzando con 9, y un
sublista con números romanos en minúscula:
9) Noveno
10) Décimo
11) Undécimo
I. subone
ii. subdos
iii. sub-tres
Pandoc iniciará una nueva lista cada vez que se utilice un tipo diferente de marcador de lista. Entonces el
lo siguiente creará tres listas:
(2) Dos
(5) Tres
1 Cuatro
* Cinco
Si desea marcadores de lista predeterminados, use # .:
#. una
#. dos
#. Tres
Definición liza
Extensión: listas_de_definiciones
Pandoc admite listas de definiciones, utilizando la sintaxis de PHP Markdown Extra con algunos
extensiones.
Plazo 1
: Definición 1
Término 2 con * marcado en línea *
: Definición 2
{algún código, parte de la definición 2}
Tercer párrafo de la definición 2.
Cada término debe caber en una línea, que opcionalmente puede ir seguida de una línea en blanco, y debe
ir seguido de una o más definiciones. Una definición comienza con dos puntos o tilde, que
puede tener una sangría de uno o dos espacios.
Un término puede tener múltiples definiciones y cada definición puede constar de uno o más bloques
elementos (párrafo, bloque de código, lista, etc.), cada uno con cuatro espacios sangrados o una tabulación.
El cuerpo de la definición (incluida la primera línea, además de los dos puntos o la tilde)
debe tener una sangría de cuatro espacios. Sin embargo, al igual que con otras listas de Markdown, puede "perezosamente"
omitir la sangría excepto al principio de un párrafo u otro elemento de bloque:
Plazo 1
: Definición
con continuación perezosa.
Segundo párrafo de la definición.
Si deja un espacio antes de la definición (como en el ejemplo anterior), el texto de la
La definición se tratará como un párrafo. En algunos formatos de salida, esto significará una mayor
espaciado entre pares término / definición. Para una lista de definiciones más compacta, omita el espacio
antes de la definición:
Plazo 1
~ Definición 1
Plazo 2
~ Definición 2a
~ Definición 2b
Tenga en cuenta que se requiere espacio entre los elementos en una lista de definición. (Una variante que afloja
este requisito, pero no permite la envoltura dura "perezosa", se puede activar con
compact_definition_lists: consulte Extensiones no pandoc, a continuación).
numerado (aqui) liza
Extensión: listas_ejemplos
El marcador de lista especial @ se puede utilizar para ejemplos numerados secuencialmente. La primera lista
elemento con un marcador @ se numerará '1', el siguiente '2', y así sucesivamente, a lo largo del
documento. Los ejemplos numerados no tienen por qué aparecer en una sola lista; cada nueva lista usando @
retomará donde se detuvo el último. Así por ejemplo:
(@) Mi primer ejemplo estará numerado (1).
(@) Mi segundo ejemplo será numerado (2).
Explicación de ejemplos.
(@) Mi tercer ejemplo será numerado (3).
Los ejemplos numerados se pueden etiquetar y mencionar en otras partes del documento:
(@bueno) Este es un buen ejemplo.
Como ilustra (@good),...
La etiqueta puede ser cualquier cadena de caracteres alfanuméricos, guiones bajos o guiones.
Compact y suelto liza
Pandoc se comporta de manera diferente a Markdown.pl en algunos "casos extremos" que involucran listas.
Considere esta fuente:
+ Primero
+ Segundo:
- Tarifa
- Vaya
- Enemigo
+ Tercero
Pandoc transforma esto en una "lista compacta" (sin etiquetas alrededor de "Primero", "Segundo",
o "Tercero"), mientras que Markdown pone etiquetas alrededor de "Segundo" y "Tercero" (pero no "Primero"),
debido al espacio en blanco alrededor de "Tercero". Pandoc sigue una regla simple: si el texto es
seguida de una línea en blanco, se trata como un párrafo. Dado que "Segundo" es seguido por un
lista, y no una línea en blanco, no se trata como un párrafo. El hecho de que la lista sea
seguido de una línea en blanco es irrelevante. (Nota: Pandoc funciona de esta manera incluso cuando el
Se especifica el formato markdown_strict. Este comportamiento es consistente con el oficial
Descripción de la sintaxis de Markdown, aunque es diferente de la de Markdown.pl.)
Ending a lista
¿Qué sucede si desea colocar un bloque de código sangrado después de una lista?
- artículo uno
- artículo dos
{ mi bloque de código }
¡Problema! Aquí pandoc (como otras implementaciones de Markdown) tratará {mi bloque de código} como
el segundo párrafo del punto dos, y no como un bloque de código.
Para "cortar" la lista después del elemento dos, puede insertar algún contenido sin sangría, como un
Comentario HTML, que no producirá resultados visibles en ningún formato:
- artículo uno
- artículo dos
{ mi bloque de código }
Puedes usar el mismo truco si quieres dos listas consecutivas en lugar de una lista grande:
1. uno
2. dos
3. tres
1. uno
2. hacer
3. tres
Horizontal reglas
Una línea que contiene una fila de tres o más caracteres *, - o _ (opcionalmente separados por
espacios) produce una regla horizontal:
* * * *
---------------
Mesas
Se pueden utilizar cuatro tipos de tablas. Los primeros tres tipos presuponen el uso de un
fuente de ancho fijo, como Courier. El cuarto tipo se puede utilizar con espaciado proporcional
fuentes, ya que no requiere alinear columnas.
Extensión: subtítulos_de_tabla
Opcionalmente, se puede proporcionar un título con los 4 tipos de tablas (como se ilustra en la
ejemplos a continuación). Un título es un párrafo que comienza con la cadena Tabla: (o simplemente :),
que será despojado. Puede aparecer antes o después de la tabla.
Extensión: tablas_simples
Las tablas simples se ven así:
Derecha Izquierda Centro Predeterminado
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
Tabla: Demostración de sintaxis de tabla simple.
Los encabezados y las filas de la tabla deben caber cada uno en una línea. Las alineaciones de las columnas están determinadas por
la posición del texto del encabezado en relación con la línea discontinua debajo de él:
· Si la línea discontinua está al mismo nivel que el texto del encabezado en el lado derecho pero se extiende más allá
a la izquierda, la columna está alineada a la derecha.
· Si la línea discontinua está al mismo nivel que el texto del encabezado en el lado izquierdo pero se extiende más allá
a la derecha, la columna está alineada a la izquierda.
· Si la línea discontinua se extiende más allá del texto del encabezado en ambos lados, la columna está centrada.
· Si la línea discontinua está al mismo nivel que el texto del encabezado en ambos lados, la alineación predeterminada es
usado (en la mayoría de los casos, esto se dejará).
La tabla debe terminar con una línea en blanco o una línea de guiones seguida de una línea en blanco.
Los encabezados de las columnas se pueden omitir, siempre que se use una línea discontinua para terminar la tabla. Para
ejemplo:
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------
Cuando se omiten los encabezados, las alineaciones de las columnas se determinan sobre la base de la primera línea
del cuerpo de la mesa. Entonces, en las tablas anteriores, las columnas serían derecha, izquierda, centro y
alineados a la derecha, respectivamente.
Extensión: tablas_multilineas
Las tablas de varias líneas permiten que los encabezados y las filas de la tabla abarquen varias líneas de texto (pero las celdas
que abarquen varias columnas o filas de la tabla no son compatibles). Aquí hay un ejemplo:
-------------------------------------------------- -----------
Centrado Predeterminado Derecha Izquierda
Encabezado Alineado Alineado Alineado
----------- ------- --------------- ----------------- --------
Primera fila 12.0 Ejemplo de una fila que
abarca varias líneas.
Segunda fila 5.0 Aquí hay otro. Nota
la línea en blanco entre
filas.
-------------------------------------------------- -----------
Tabla: Aquí está el título. También puede abarcar
Múltiples líneas.
Estos funcionan como tablas simples, pero con las siguientes diferencias:
· Deben comenzar con una fila de guiones, antes del texto del encabezado (a menos que los encabezados sean
omitido).
· Deben terminar con una fila de guiones, luego una línea en blanco.
· Las filas deben estar separadas por líneas en blanco.
En las tablas multilínea, el analizador de tablas presta atención a los anchos de las columnas y el
los escritores intentan reproducir estos anchos relativos en la salida. Entonces, si encuentras que uno de
las columnas son demasiado estrechas en la salida, intente ampliarlas en la fuente de Markdown.
Los encabezados se pueden omitir en las tablas de varias líneas, así como en las tablas simples:
----------- ------- --------------- ----------------- --------
Primera fila 12.0 Ejemplo de una fila que
abarca varias líneas.
Segunda fila 5.0 Aquí hay otro. Nota
la línea en blanco entre
filas.
----------- ------- --------------- ----------------- --------
: Aquí hay una tabla de varias líneas sin encabezados.
Es posible que una tabla de varias líneas tenga una sola fila, pero la fila debe seguirse
por una línea en blanco (y luego la fila de guiones que termina la tabla), o la tabla puede ser
interpretado como una tabla simple.
Extensión: tablas_cuadriculas
Las tablas de cuadrícula se ven así:
: Tabla de cuadrícula de muestra.
+---------------+---------------+----------------- ---+
| Fruta | Precio | Ventajas |
+===============+===============+================= ===+
| Plátanos | $1.34 | - envoltorio incorporado |
| | | - color brillante |
+---------------+---------------+----------------- ---+
| naranjas | $2.10 | - cura el escorbuto |
| | | - sabroso |
+---------------+---------------+----------------- ---+
La fila de =s separa el encabezado del cuerpo de la tabla y se puede omitir para un
tabla sin encabezado Las celdas de las tablas de cuadrícula pueden contener elementos de bloque arbitrarios (múltiples
párrafos, bloques de código, listas, etc.). No se admiten alineaciones ni celdas que
abarcar varias columnas o filas. Las tablas de cuadrícula se pueden crear fácilmente usando el modo de tabla de Emacs.
Extensión: tablas_tuberías
Las tablas de tuberías se ven así:
| Derecha | Izquierda | Predeterminado | Centro |
|------:|:-----|---------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |
: Demostración de la sintaxis de la tabla de tuberías.
La sintaxis es idéntica a las tablas PHP Markdown Extra. El tubo inicial y final
los caracteres son opcionales, pero se requieren conductos entre todas las columnas. Los dos puntos indican
alineación de la columna como se muestra. El encabezado no se puede omitir. Para simular una tabla sin encabezado,
incluir un encabezado con celdas en blanco.
Dado que las tuberías indican los límites de las columnas, no es necesario alinearlas verticalmente, ya que
están en el ejemplo anterior. Entonces, esta es una tabla de tuberías perfectamente legal (aunque fea):
fruta| precio
-----|-----:
manzana|2.05
pera|1.37
naranja|3.09
Las celdas de las tablas de tuberías no pueden contener elementos de bloque como párrafos y listas, y
no puede abarcar varias líneas. Si una tabla de tuberías contiene una fila cuyo contenido imprimible es
más ancho que el ancho de la columna (ver --columns), entonces el contenido de la celda se ajustará, con el
anchos de celda relativos determinados por los anchos de las líneas separadoras.
Nota: pandoc también reconoce tablas de tuberías de la siguiente forma, como puede ser producido por
Modo orgtbl de Emacs:
| uno | Dos |
|-----+-------|
| mi | mesa |
| es | agradable |
La diferencia es que se usa + en lugar de |. No se admiten otras características de orgtbl.
En particular, para obtener una alineación de columna no predeterminada, deberá agregar dos puntos como se indicó anteriormente.
metadatos bloques
Extensión: bloque_título_pandoc
Si el archivo comienza con un bloque de título
% título
% autor(es) (separados por punto y coma)
% fecha
se analizará como información bibliográfica, no como texto normal. (Se utilizará, por
ejemplo, en el título de la salida LaTeX o HTML independiente.) El bloque puede contener solo un
título, un título y un autor, o los tres elementos. Si desea incluir un autor pero
sin título, o un título y una fecha pero sin autor, necesita una línea en blanco:
%
% autor
% Mi título
%
% 15 de junio de 2006
El título puede ocupar varias líneas, pero las líneas de continuación deben comenzar con un espacio inicial,
así:
% Mi título
en varias líneas
Si un documento tiene varios autores, los autores pueden colocarse en líneas separadas con
espacio, o separados por punto y coma, o ambos. Entonces, todos los siguientes son equivalentes:
% autor uno
Autor dos
% Autor Uno; Autor dos
% Autor Uno;
Autor dos
La fecha debe caber en una línea.
Los tres campos de metadatos pueden contener formato en línea estándar (cursiva, enlaces,
notas a pie de página, etc).
Los bloques de título siempre se analizarán, pero afectarán la salida solo cuando el
Se elige la opción independiente (-s). En la salida HTML, los títulos aparecerán dos veces: una vez en el
encabezado del documento: este es el título que aparecerá en la parte superior de la ventana en un navegador
-- y una vez al principio del cuerpo del documento. El título en el encabezado del documento puede
tener un prefijo opcional adjunto (--título-prefijo u opción -T). El título en el cuerpo.
aparece como un elemento H1 con clase "título", por lo que se puede suprimir o reformatear con
CSS. Si se especifica un prefijo de título con -T y no aparece ningún bloque de título en el documento,
el prefijo del título se utilizará solo como título HTML.
El escritor de la página del manual extrae un título, un número de sección de la página del manual y otros encabezados y pies de página.
información de la línea del título. Se supone que el título es la primera palabra del título.
línea, que opcionalmente puede terminar con un número de sección (de un solo dígito) entre paréntesis.
(No debe haber espacio entre el título y los paréntesis.) Cualquier cosa después de esto es
se supone que es texto adicional de pie de página y encabezado. Un solo carácter de barra vertical (|) debe ser
Se utiliza para separar el texto del pie de página del texto del encabezado. Por lo tanto,
% PANDOC(1)
generará una página man con el título PANDOC y la sección 1.
% PANDOC(1) Manuales de usuario de Pandoc
también tendrá "Manuales de usuario de Pandoc" en el pie de página.
% PANDOC(1) Manuales de usuario de Pandoc | Versión 4.0
también tendrá "Versión 4.0" en el encabezado.
Extensión: yaml_metadata_block
Un bloque de metadatos YAML es un objeto YAML válido, delimitado por una línea de tres guiones (---)
en la parte superior y una línea de tres guiones (---) o tres puntos (...) en la parte inferior. UN YAML
El bloque de metadatos puede ocurrir en cualquier parte del documento, pero si no está al principio,
debe ir precedida de una línea en blanco. (Tenga en cuenta que, debido a la forma en que pandoc concatena
archivos de entrada cuando se proporcionan varios, también puede mantener los metadatos en un YAML separado
y páselo a pandoc como argumento, junto con sus archivos Markdown:
pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o libro.html
Solo asegúrese de que el archivo YAML comience con --- y termine con --- o ....)
Los metadatos se tomarán de los campos del objeto YAML y se agregarán a cualquier
metadatos del documento. Los metadatos pueden contener listas y objetos (anidados arbitrariamente), pero todos
los escalares de cadena se interpretarán como Markdown. Campos con nombres que terminan en un guión bajo
será ignorado por pandoc. (Es posible que los procesadores externos les den una función).
Un documento puede contener varios bloques de metadatos. Los campos de metadatos se combinarán
a través de un sesgado a la izquierda unión: si dos bloques de metadatos intentan establecer el mismo campo, el
Se tomará el valor del primer bloque.
Cuando pandoc se usa con -t markdown para crear un documento Markdown, un bloque de metadatos YAML
se producirá solo si se usa la opción -s/--standalone. Todos los metadatos se
aparecen en un solo bloque al principio del documento.
Tenga en cuenta que se deben seguir las reglas de escape de YAML. Así, por ejemplo, si un título contiene un
dos puntos, debe citarse. El carácter de barra vertical (|) se puede usar para comenzar un bloque sangrado
que se interpretará literalmente, sin necesidad de evasión. Este formulario es necesario
cuando el campo contiene líneas en blanco:
. . .
title: 'Este es el título: contiene dos puntos'
autor:
- nombre: Autor Uno
afiliación: Universidad de algún lugar
- nombre: Autor Dos
afiliación: Universidad de la nada
etiquetas: [nada, la nada]
resumen: |
Este es el resumen.
Consta de dos párrafos.
...
Las variables de la plantilla se establecerán automáticamente a partir de los metadatos. Así, por ejemplo, en
escribiendo HTML, la variable resumen se establecerá en el equivalente HTML de Markdown en
el campo abstracto:
Este es el resumen.
Consta de dos párrafos.
Nota: La variable de autor en las plantillas predeterminadas espera una lista o cadena simple. A
use los autores estructurados en el ejemplo, necesitaría una plantilla personalizada. Por ejemplo:
$ para (autor) $
$if(autor.nombre)$
$autor.nombre$$if(autor.afiliación)$ ($autor.afiliación$)$endif$
$ else $
$autor$
$ endif $
$ endfor $
Barra invertida escapes
Extensión: todos_los_símbolos_escapables
Excepto dentro de un bloque de código o código en línea, cualquier signo de puntuación o espacio precedido por
una barra invertida se tratará literalmente, incluso si normalmente indicaría formato.
Así, por ejemplo, si se escribe
*\*Hola\**
uno obtendrá
*Hola*
en lugar de
Hola
Esta regla es más fácil de recordar que la regla estándar de Markdown, que permite que solo el
siguientes caracteres que se escaparán con barra invertida:
\`*_{}[]()>#+-.!
(Sin embargo, si se usa el formato markdown_strict, se usará la regla Markdown estándar).
Un espacio con escape de barra invertida se analiza como un espacio de no separación. Aparecerá en la salida de TeX.
como ~ y en HTML y XML como \ o \ .
Se analiza una nueva línea con barra invertida escapada (es decir, una barra invertida que aparece al final de una línea)
como un salto de línea duro. Aparecerá en la salida de TeX como \\ y en HTML como . Esto es
una buena alternativa a la forma "invisible" de Markdown de indicar saltos de línea duros usando dos
espacios finales en una línea.
Los escapes de barra invertida no funcionan en contextos literales.
Smart puntuación
Extension
Si se especifica la opción --smart, pandoc producirá una salida tipográficamente correcta,
convertir comillas rectas en comillas curvas, --- en guiones largos, -- en guiones cortos y ... en
elipses Los espacios de no separación se insertan después de ciertas abreviaturas, como "Sr."
Nota: si su plantilla de LaTeX o cualquier archivo de encabezado incluido requiere el paquete csquotes,
pandoc detectará esto automáticamente y usará \enquote{...} para el texto citado.
En línea formato
énfasis
A enfatizar algún texto, rodéelo con *s o _, así:
Este texto está _enfatizado con guiones bajos_, y este
es *enfatizado con asteriscos*.
Doble * o _ produce fuertes énfasis:
Esto es **énfasis fuerte** y __con guiones bajos__.
Un carácter * o _ rodeado de espacios, o con una barra invertida escapada, no activará el énfasis:
Esto *no está enfatizado*, y \*esto tampoco\*.
Extensión: intraword_guiones bajos
Debido a que _ a veces se usa dentro de palabras e identificadores, pandoc no interpreta un _
rodeado de caracteres alfanuméricos como marcador de énfasis. Si quieres enfatizar
solo parte de una palabra, use *:
factible*, no factible*.
Strikeout
Extensión: tachar
Para tachar una sección de texto con una línea horizontal, comience y termine con ~~. Por lo tanto,
por ejemplo,
Este ~~es texto eliminado.~~
Superíndices y subíndices
Extensión: sobrescrito, subíndice
Los superíndices se pueden escribir rodeando el texto superíndice con ^ caracteres;
los subíndices se pueden escribir rodeando el texto subíndice con ~ caracteres. Así, por
ejemplo,
H~2~O es un líquido. 2^10^ es 1024.
Si el texto en superíndice o subíndice contiene espacios, estos espacios deben escaparse
con barras invertidas. (Esto es para evitar superíndices y subíndices accidentales a través de
el uso ordinario de ~ y ^.) Por lo tanto, si desea la letra P con 'un gato' en subíndices,
usa P~a\ cat~, no P~a cat~.
Literal
Para hacer un fragmento corto de texto palabra por palabra, colóquelo dentro de tildes:
¿Cuál es la diferencia entre `>>=` y `>>`?
Si el texto textual incluye un acento grave, utilice dobles acentos graves:
Aquí hay un acento grave literal `` ` ``.
(Los espacios después de las comillas graves de apertura y antes de las comillas graves de cierre se ignorarán).
La regla general es que un lapso textual comienza con una serie de acentos graves consecutivos.
(opcionalmente seguido de un espacio) y termina con una cadena del mismo número de acentos graves
(opcionalmente precedido por un espacio).
Tenga en cuenta que los escapes de barra invertida (y otras construcciones de Markdown) no funcionan textualmente
contextos:
Esta es una barra invertida seguida de un asterisco: `\*`.
Extensión: atributos_de_código_en_línea
Los atributos se pueden adjuntar al texto textual, al igual que con los bloques de código delimitados:
`<$>`{.haskell}
Pequeña tapas
Para escribir en versalitas, puede usar una etiqueta de intervalo HTML:
Letras minúsculas
(El punto y coma es opcional y puede haber un espacio después de los dos puntos). Esto funcionará en todos
formatos de salida que admiten versalitas.
Matemáticas
Extensión: tex_math_dollars
Cualquier cosa entre dos caracteres $ se tratará como matemática TeX. El $ de apertura debe tener un
carácter sin espacio inmediatamente a su derecha, mientras que el cierre $ debe tener un carácter sin espacio
carácter inmediatamente a su izquierda, y no debe ser seguido inmediatamente por un dígito. Por lo tanto,
$ 20,000 y $ 30,000 no se analizarán como matemáticas. Si por alguna razón necesita adjuntar texto en
caracteres $ literales, escápelos con barra invertida y no se tratarán como delimitadores matemáticos.
Las matemáticas de TeX se imprimirán en todos los formatos de salida. Cómo se renderiza depende de la salida.
formato:
Reducción, Látex, emacs Org modo, Contexto
Aparecerá palabra por palabra entre los caracteres $.
reStructuredText
Se representará utilizando un rol de texto interpretado :math:.
AsciiDoc
Se representará como latexmath:[...].
Texinfo
Se representará dentro de un comando @math.
grof hombre
Se traducirá textualmente sin $.
medioswiki, DokuWiki
se representará dentro etiquetas
Textil
Se representará dentro de las etiquetas.
RTF, documento abierto, ODT
Se representará, si es posible, utilizando caracteres Unicode y, de lo contrario,
aparecer textualmente.
DocBook
Si se usa el indicador --mathml, se representará usando MathML en una ecuación en línea
o etiqueta de ecuación informal. De lo contrario, se renderizará, si es posible, utilizando Unicode.
personajes.
Docx Se representará utilizando el marcado matemático OMML.
FicciónLibro2
Si se usa la opción --webtex, las fórmulas se representan como imágenes usando Google Charts
u otro servicio web compatible, descargado e integrado en el libro electrónico. De lo contrario,
aparecerán textualmente.
HTML, resbaladizo, Diapositivas DZ, S5, EPUB
La forma en que se representan las matemáticas en HTML dependerá de las opciones de línea de comandos seleccionadas:
1. El valor predeterminado es representar las matemáticas de TeX en la medida de lo posible utilizando caracteres Unicode,
como con la salida RTF, DocBook y OpenDocument. Las fórmulas se ponen dentro de un lapso
con class="math", para que puedan tener un estilo diferente al de los alrededores
texto si es necesario.
2. Si se usa la opción --latexmathml, TeX math se mostrará entre $ o $$
caracteres y poner etiquetas con la clase LaTeX. La secuencia de comandos LaTeXMathML
utilizarse para representarlo como fórmulas. (Este truco no funciona en todos los navegadores,
pero funciona en Firefox. En navegadores que no soportan LaTeXMathML, TeX math
aparecerá textualmente entre los caracteres $).
3. Si se usa la opción --jsmath, TeX math se colocará dentro de las etiquetas (por
matemáticas en línea) o etiquetas (para matemáticas de visualización) con matemáticas de clase. El jsMath
script se utilizará para representarlo.
4. Si se usa la opción --mimetex, se llamará al script mimeTeX CGI para
generar imágenes para cada fórmula TeX. Esto debería funcionar en todos los navegadores. El
La opción --mimetex toma una URL opcional como argumento. Si no se especifica ninguna URL,
se supondrá que el script mimeTeX CGI está en /cgi-bin/mimetex.cgi.
5. Si se usa la opción --gladtex, las fórmulas TeX se incluirán entre etiquetas en
la salida HTML. El archivo htex resultante puede ser procesado por gladTeX,
que producirá archivos de imagen para cada fórmula y un archivo HTML con enlaces a
estas imagenes. Entonces, el procedimiento es:
pandoc -s --gladtex miarchivo.txt -o miarchivo.htex
gladtex -d miarchivo-imágenes miarchivo.htex
# produce myfile.html e imágenes en myfile-images
6. Si se usa la opción --webtex, las fórmulas TeX se convertirán a etiquetas
ese enlace a un script externo que convierte fórmulas en imágenes. La formula
se codificará como URL y se concatenará con la URL proporcionada. Si no hay URL
especificado, se utilizará la API de gráficos de Google
(http://chart.apis.google.com/chart?cht=tx&chl=).
7. Si se usa la opción --mathjax, TeX math se mostrará entre \(...\) (para
matemáticas en línea) o \[...\] (para mostrar matemáticas) y poner etiquetas con clase
Matemáticas. El script MathJax se usará para representarlo como fórmulas.
Crudo HTML
Extensión: raw_html
Markdown le permite insertar HTML sin procesar (o DocBook) en cualquier parte de un documento (excepto
contextos textuales, donde <, > y & se interpretan literalmente). (Técnicamente esto no es
una extensión, ya que Markdown estándar lo permite, pero se ha hecho una extensión para que
se puede desactivar si se desea.)
El HTML sin procesar se pasa sin cambios en HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Markdown y Textil y suprimidos en otros formatos.
Extensión: markdown_in_html_blocks
Standard Markdown le permite incluir "bloques" HTML: bloques de HTML entre balanceados
etiquetas que están separadas del texto circundante con líneas en blanco, y comienzan y terminan en
el margen izquierdo. Dentro de estos bloques, todo se interpreta como HTML, no como Markdown; entonces
(por ejemplo), * no significa énfasis.
Pandoc se comporta de esta manera cuando se usa el formato markdown_strict; pero por defecto, pandoc
interpreta el material entre etiquetas de bloque HTML como Markdown. Así, por ejemplo, pandoc
giro
*una*
[un enlace](http://google.com)
into
una
<a href="/http://google.com">un enlace
mientras que Markdown.pl lo conservará tal cual.
Hay una excepción a esta regla: el texto entre and tags is not
interpretado como Markdown.
Esta desviación del Markdown estándar debería facilitar la combinación de Markdown con HTML.
elementos de bloque. Por ejemplo, uno puede rodear un bloque de texto Markdown con etiquetas
sin evitar que se interprete como Markdown.
Extensión: nativo_divs
Use bloques pandoc Div nativos para el contenido interno etiquetas En su mayor parte, esto debería
da el mismo resultado que markdown_in_html_blocks, pero hace que sea más fácil escribir pandoc
filtros para manipular grupos de bloques.
Extensión: tramos_nativos
Use bloques pandoc nativos Span para el contenido dentro de las etiquetas. En su mayor parte esto
debería dar el mismo resultado que raw_html, pero hace que sea más fácil escribir filtros pandoc en
manipular grupos de líneas.
Crudo Texas
Extensión: crudo_tex
Además de HTML sin procesar, pandoc permite incluir LaTeX, TeX y ConTeXt sin procesar en un
documento. Los comandos TeX en línea se conservarán y pasarán sin cambios a LaTeX y
escritores de contexto. Así, por ejemplo, puedes usar LaTeX para incluir citas de BibTeX:
Este resultado fue probado en \cite{jones.1967}.
Tenga en cuenta que en entornos LaTeX, como
\begin{tabular}{|l|l|}\hline
Edad y frecuencia \\ \hline
18--25 y 15 \\
26--35 y 33 \\
36--45 y 22 \\ \hlínea
\ end {tabular}
el material entre las etiquetas de inicio y finalización se interpretará como LaTeX sin formato, no como
Reducción.
Inline LaTeX se ignora en formatos de salida que no sean Markdown, LaTeX y ConTeXt.
Látex macros
Extensión: macros_latex
Para formatos de salida que no sean LaTeX, pandoc analizará LaTeX \newcommand y \renewcommand
definiciones y aplicar las macros resultantes a todas las matemáticas de LaTeX. Así, por ejemplo, el
lo siguiente funcionará en todos los formatos de salida, no solo en LaTeX:
\nuevocomando{\tupla}[1]{\langle #1 \rangle}
$\tupla{a, b, c}$
En la salida de LaTeX, la definición de \newcommand simplemente se pasará sin cambios a la salida.
Enlaces
Markdown permite que los enlaces se especifiquen de varias maneras.
Automático enlaces
Si incluye una URL o una dirección de correo electrónico entre corchetes puntiagudos, se convertirá en un enlace:
<http://google.com>
<[email protected]>
En línea enlaces
Un enlace en línea consta del texto del enlace entre corchetes, seguido de la URL en
paréntesis. (Opcionalmente, la URL puede ir seguida de un título de enlace, entre comillas).
Este es un [enlace en línea](/url), y aquí está [uno con
un título](http://fsf.org "¡haz clic aquí para pasar un buen rato!").
No puede haber espacio entre la parte entre paréntesis y la parte entre paréntesis. El enlace
el texto puede contener formato (como énfasis), pero el título no.
Las direcciones de correo electrónico en los enlaces en línea no se detectan automáticamente, por lo que deben tener el prefijo con
mailto:
[¡Escríbeme!](mailto:[email protected])
Referencias enlaces
An explícito enlace de referencia tiene dos partes, el enlace en sí y la definición del enlace, que
puede aparecer en otra parte del documento (ya sea antes o después del enlace).
El enlace consta de texto de enlace entre corchetes, seguido de una etiqueta entre corchetes.
(Puede haber espacio entre los dos.) La definición del enlace consiste en la etiqueta entre corchetes,
seguido de dos puntos y un espacio, seguido de la URL y, opcionalmente (después de un espacio), un
título del enlace entre comillas o entre paréntesis. La etiqueta no debe ser analizable como un
cita (asumiendo que la extensión de citas está habilitada): las citas tienen prioridad sobre
etiquetas de enlace
He aquí algunos ejemplos:
[mi etiqueta 1]: /foo/bar.html "Mi título, opcional"
[mi etiqueta 2]: /foo
[mi etiqueta 3]: http://fsf.org (La fundación del software libre)
[mi etiqueta 4]: /bar#special 'Un título entre comillas simples'
La URL puede estar opcionalmente rodeada por corchetes angulares:
[mi etiqueta 5]:http://foo.bar.baz>
El título puede ir en la siguiente línea:
[mi etiqueta 3]: http://fsf.org
"La fundación del software libre"
Tenga en cuenta que las etiquetas de enlace no distinguen entre mayúsculas y minúsculas. Entonces, esto funcionará:
Aquí está [mi enlace][FOO]
[Foo]: /bar/baz
En una implícitamente enlace de referencia, el segundo par de corchetes está vacío:
Ver [mi sitio web][].
[Mi sitio web]: http://foo.bar.baz
Nota: En Markdown.pl y la mayoría de las otras implementaciones de Markdown, las definiciones de enlaces de referencia
no puede ocurrir en construcciones anidadas como elementos de lista o citas en bloque. Ascensores Pandoc
esta restricción aparentemente arbitraria. Entonces, lo siguiente está bien en pandoc, aunque no en
la mayoría de las otras implementaciones:
> Mi bloque [cita].
>
> [cita]: /foo
Extensión: acceso directo_referencia_enlaces
En un atajo enlace de referencia, el segundo par de corchetes puede omitirse por completo:
Ver [mi sitio web].
[Mi sitio web]: http://foo.bar.baz
Interno enlaces
Para vincular a otra sección del mismo documento, utilice el generado automáticamente
identificador (ver Identificadores de encabezado). Por ejemplo:
Consulte la [Introducción](#introducción).
or
Consulte la [Introducción].
[Introducción]: #introducción
Actualmente, los enlaces internos son compatibles con los formatos HTML (incluidas las presentaciones de diapositivas HTML y
EPUB), LaTeX y ConTeXt.
Imágenes
Un enlace inmediatamente precedido por un ! será tratada como una imagen. El texto del enlace será
utilizado como texto alternativo de la imagen:
![carrete de película]
[carrete de película]: movie.gif
Extensión: figuras_implícitas
Una imagen que aparece sola en un párrafo se representará como una figura con un título.
(En LaTeX, se utilizará un entorno de figura; en HTML, la imagen se colocará en un div
con figura de clase, junto con un título en ap con título de clase.) La imagen es alternativa
el texto se utilizará como título.
Si solo desea una imagen en línea regular, asegúrese de que no sea lo único en el
párrafo. Una forma de hacer esto es insertar un espacio que no se rompa después de la imagen:
\
Extensión: atributos_enlace
Los atributos se pueden establecer en enlaces e imágenes:
Una {#id .class width=30 height=20px} en línea
y una referencia ![imagen][ref] con atributos.
[ref]: foo.jpg "título opcional" {#id .class key=val key2="val 2"}
(Esta sintaxis es compatible con PHP Markdown Extra cuando solo se usan #id y .class).
Para HTML y EPUB, todos los atributos excepto ancho y alto (pero incluidos srcset y tamaños)
se pasan tal cual. Los otros escritores ignoran los atributos que no son compatibles con
su formato de salida.
Los atributos de ancho y alto en las imágenes se tratan de manera especial. Cuando se usa sin un
unidad, se supone que la unidad son píxeles. Sin embargo, cualquiera de los siguientes identificadores de unidad
se puede utilizar: px, cm, mm, in, inch y %. No debe haber espacios entre el número
y la unidad. Por ejemplo:
{ ancho=50% }
· Las dimensiones se convierten a pulgadas para la salida en formatos basados en páginas como LaTeX.
Las dimensiones se convierten en píxeles para la salida en formatos similares a HTML. Usa el --dpi
opción para especificar el número de píxeles por pulgada. El valor predeterminado es 96 ppp.
· La unidad % es generalmente relativa a algún espacio disponible. Por ejemplo el ejemplo anterior
rendirá a (HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX), o
\externalfigure[archivo.jpg][ancho=0.5\textwidth] (ConTeXt).
· Algunos formatos de salida tienen una noción de clase (ConTeXt) o un identificador único (LaTeX
\caption), o ambos (HTML).
· Cuando no se especifican atributos de ancho o alto, la alternativa es mirar la imagen
resolución y los metadatos de ppp incrustados en el archivo de imagen.
Notas a pie de página
Extensión: notas al pie
Markdown de Pandoc permite notas al pie, usando la siguiente sintaxis:
Aquí hay una referencia de nota al pie,[^1] y otra.[^nota larga]
[^1]: Aquí está la nota al pie.
[^longnote]: aquí hay uno con varios bloques.
Los párrafos siguientes tienen sangría para mostrar que
pertenecen a la nota al pie anterior.
{ algún.código }
Se puede sangrar todo el párrafo, o solo el primero.
línea. De esta manera, las notas al pie de varios párrafos funcionan como
elementos de lista de varios párrafos.
Este párrafo no será parte de la nota, porque
no está sangrado.
Los identificadores en las referencias de las notas al pie no pueden contener espacios, tabulaciones o saltos de línea. Estos
los identificadores se usan solo para correlacionar la referencia de la nota al pie con la nota misma; en el
salida, las notas al pie se numerarán secuencialmente.
No es necesario colocar las notas al pie de página al final del documento. pueden aparecer
en cualquier lugar excepto dentro de otros elementos de bloque (listas, citas de bloque, tablas, etc.).
Extensión: notas_en-linea
También se permiten notas al pie en línea (aunque, a diferencia de las notas regulares, no pueden contener
varios párrafos). La sintaxis es la siguiente:
Aquí hay una nota en línea.^[Las notas en línea son más fáciles de escribir, ya que
no tiene que elegir un identificador y moverse hacia abajo para escribir el
Nota.]
Las notas a pie de página regulares y en línea se pueden mezclar libremente.
Citaciones
Extensión: comillas
Usando un filtro externo, pandoc-citeproc, pandoc puede generar automáticamente citas y
una bibliografía en varios estilos. El uso básico es
pandoc --filtro pandoc-citeproc mientrada.txt
Para utilizar esta función, deberá especificar un archivo de bibliografía utilizando el
campo de metadatos de bibliografía en una sección de metadatos YAML, o línea de comando --bibliography
argumento. Puede proporcionar varios argumentos --bibliography o establecer metadatos de bibliografía
campo a la matriz YAML, si desea utilizar varios archivos de bibliografía. La bibliografía puede
tener alguno de estos formatos:
Formato Extensión de archivo
─────────────────────────────
BibLaTeX .bib
BibTeX .bibtex
Copac .copac
CSL JSON.json
CSL YAML.yaml
Nota final .enl
Nota final XML .xml
ISI .wos
MEDLINE.medline
MODS .mods
RIS.ris
Tenga en cuenta que .bib se puede usar con archivos BibTeX y BibLaTeX; usa .bibtex para forzar
BibTeX.
Tenga en cuenta que pandoc-citeproc --bib2json y pandoc-citeproc --bib2yaml pueden producir .json y
Archivos .yaml de cualquiera de los formatos admitidos.
Marcado en el campo: en las bases de datos BibTeX y BibLaTeX, pandoc-citeproc analiza un subconjunto de
marcado LaTeX; en bases de datos CSL YAML, pandoc Markdown; y en las bases de datos CSL JSON, un
Marcado similar a HTML:
cursiva
...
<Span style="font-variant:small-caps;">... or ...
pequeñas capitales
...
subíndice
...
sobrescrito
<Span clase="sincaso">...
evitar que una frase se escriba en mayúsculas como caso de título
pandoc-citeproc -j y -y interconvierten los formatos CSL JSON y CSL YAML en la medida de lo posible
posible.
Como alternativa a especificar un archivo de bibliografía usando --bibliography o YAML
bibliografía del campo de metadatos, puede incluir los datos de citas directamente en las referencias
campo de los metadatos YAML del documento. El campo debe contener una matriz de códigos YAML
referencias, por ejemplo:
. . .
referencias:
- tipo: artículo-revista
identificación: WatsonCrick1953
autor:
- familia: watson
dado: JD
- familia: Crick
dado: FHC
emitido:
fechas-partes:
- - 1953
- 4
- 25
título: 'Estructura molecular de los ácidos nucleicos: una estructura para la desoxirribosa
ácido nucleico'
título abreviado: Estructura molecular de los ácidos nucleicos
container-title: Naturaleza
volumen: 171
problema: 4356
página: 737-738
DOI: 10.1038/171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
idioma: es-ES
...
(pandoc-citeproc --bib2yaml puede generarlos a partir de un archivo de bibliografía en uno de los
formatos admitidos).
Las citas y las referencias se pueden formatear usando cualquier estilo compatible con Citation Style
Idioma, listado en el Repositorio de estilos de Zotero. Estos archivos se especifican utilizando el
opción --csl o el campo de metadatos csl. Por defecto, pandoc-citeproc usará el Chicago
Manual de Estilo formato autor-fecha. El proyecto CSL proporciona más información sobre
búsqueda y edición de estilos.
Para hacer que sus citas sean hipervínculos a las entradas bibliográficas correspondientes, agregue
citas de enlaces: fiel a sus metadatos YAML.
Las citas van entre corchetes y están separadas por punto y coma. Cada cita debe
tener una clave, compuesta por '@' + el identificador de cita de la base de datos, y puede
opcionalmente tener un prefijo, un localizador y un sufijo. La clave de cita debe comenzar con un
letra, dígito o _, y puede contener caracteres alfanuméricos, _ y signos de puntuación internos
(:.#$%&-+?<>~/). Aquí hay unos ejemplos:
Bla, bla, bla [ver @doe99, págs. 33-35; también @smith04, cap. 1].
Bla, bla [@doe99, págs. 33-35, 38-39 y *passim*].
Bla, bla, bla [@smith04; @doe99].
pandoc-citeproc detecta los términos del localizador en los archivos de configuración regional de CSL. Ya sea abreviado o
Se aceptan formularios no abreviados. En la configuración regional en-US, los términos del localizador se pueden escribir en
formas singulares o plurales, como libro, bk./bks.; capítulo, cap./caps.; columna,
columna/col.; figura, fig./figs.; folio, fol./fol.; número, n.º/n.º; línea, l./ll.; Nota,
n./nn.; opus, op./opp.; página, p./pp.; párrafo, párrafo/párrs.; parte, pt./pts.; sección,
seg./seg.; sub verbo, sv/s.vv.; verso, v./vv.; volumen, vol./vol.; ¶/¶¶; §/§§. Si no
se utiliza el término localizador, se asume "página".
Un signo menos (-) antes de la @ suprimirá la mención del autor en la cita. Esta
puede ser útil cuando el autor ya se menciona en el texto:
Smith dice bla [-@smith04].
También puede escribir una cita en el texto, de la siguiente manera:
@ smith04 dice bla.
@smith04 [pág. 33] dice bla.
Si el estilo requiere una lista de obras citadas, se colocará al final del
documento. Normalmente, querrá terminar su documento con un encabezado apropiado:
ultimo parrafo...
# Referencias
La bibliografía se insertará después de este encabezado. Tenga en cuenta que la clase no numerada
se agregará a este encabezado, por lo que la sección no estará numerada.
Si desea incluir elementos en la bibliografía sin citarlos en el cuerpo
texto, puede definir un campo de metadatos de nocita ficticio y colocar las citas allí:
. . .
nocitar: |
@elemento1, @elemento2
...
@artículo3
En este ejemplo, el documento contendrá una cita solo para el artículo 3, pero la bibliografía
contendrá entradas para item1, item2 y item3.
Para la salida de LaTeX o PDF, también puede usar natbib o biblatex para representar la bibliografía. En
Para hacerlo, especifique los archivos de bibliografía como se describe anteriormente y agregue --natbib o
--argumento biblatex para la invocación de pandoc. Tenga en cuenta que los archivos de bibliografía deben ser
en el formato respectivo (ya sea BibTeX o BibLaTeX).
Para obtener más información, consulte la página del manual de pandoc-citeproc.
no pandoc extensiones
Las siguientes extensiones de sintaxis de Markdown no están habilitadas de forma predeterminada en pandoc, pero pueden estar
se habilita agregando + EXTENSIÓN al nombre del formato, donde EXTENSIÓN es el nombre del
extensión. Así, por ejemplo, markdown+hard_line_breaks es Markdown con línea dura
descansos
Extensión: listas_sin_precedente_línea_en_blanco
Permita que aparezca una lista justo después de un párrafo, sin espacios en blanco intermedios.
Extensión: rupturas_de_linea_dura
Hace que todas las líneas nuevas dentro de un párrafo se interpreten como saltos de línea duros en lugar de
espacios
Extensión: ignorar_line_breaks
Hace que se ignoren las líneas nuevas dentro de un párrafo, en lugar de tratarlas como espacios o
como saltos de línea duros. Esta opción está pensada para usarse con idiomas de Asia oriental donde
no se utilizan espacios entre palabras, pero el texto se divide en líneas para facilitar la lectura.
Extensión: rupturas_de_la_linea_de_asia_del_este
Hace que se ignoren las líneas nuevas dentro de un párrafo, en lugar de tratarlas como espacios o
como saltos de línea duros, cuando se producen entre dos caracteres anchos de Asia oriental. Esto es un
mejor opción que ignore_line_breaks para textos que incluyen una mezcla de Asia oriental
personajes y otros personajes.
Extensión: emoji
Analiza emojis textuales como :smile: como emoticonos Unicode.
Extensión: tex_math_single_barra invertida
Hace que cualquier cosa entre \( y \) se interprete como matemática TeX en línea, y cualquier cosa
entre \[ y \] para ser interpretado como display TeX math. Nota: un inconveniente de esto
extensión es que impide escapar ( y [.
Extensión: tex_math_doble_barra invertida
Hace que cualquier cosa entre \\( y \\) se interprete como matemática TeX en línea, y cualquier cosa
entre \\[ y \\] para que se interprete como visualización matemática de TeX.
Extensión: markdown_atributo
De forma predeterminada, pandoc interpreta el material dentro de las etiquetas de nivel de bloque como Markdown. Esta
La extensión cambia el comportamiento para que Markdown solo se analice dentro de las etiquetas de nivel de bloque si
las etiquetas tienen el atributo markdown=1.
Extensión: mmd_title_block
Habilita un bloque de título de estilo MultiMarkdown en la parte superior del documento, por ejemplo:
Título: Mi título
Autor: John Doe
Fecha: Septiembre 1, 2008
Comentario: Este es un bloque de título mmd de muestra, con
un campo que abarca varias líneas.
Consulte la documentación de MultiMarkdown para obtener más detalles. Si pandoc_title_block o
yaml_metadata_block está habilitado, tendrá prioridad sobre mmd_title_block.
Extensión: abreviaturas
Analiza las claves de abreviatura PHP Markdown Extra, como
*[HTML]: lenguaje de marcado de hipertexto
Tenga en cuenta que el modelo de documento pandoc no admite abreviaturas, por lo que si esta extensión
está habilitado, las claves de abreviatura simplemente se omiten (en lugar de analizarse como
párrafos).
Extensión: autolink_bare_uris
Convierte todos los URI absolutos en enlaces, incluso cuando no están rodeados por llaves puntiagudas <...>.
Extensión: identificadores_ascii
Hace que los identificadores producidos por auto_identifiers sean ASCII puros. Los acentos son
se eliminan las letras latinas acentuadas y se omiten las letras no latinas.
Extensión: mmd_link_atributos
Analiza atributos de valor-clave de estilo multimarkdown en referencias de enlaces e imágenes. Esta
La extensión no debe confundirse con la extensión link_attributes.
¡Esta es una referencia! [Imagen] [ref] con atributos multimarkdown.
[árbitro]: http://path.to/image "Título de la imagen" ancho = 20 px alto = 30 px
id=miId clase="miClase1 miClase2"
Extensión: mmd_header_identificadores
Analiza los identificadores de encabezado de estilo multimarkdown (entre corchetes, después del encabezado pero
antes de cualquier # final en un encabezado ATX).
Extensión: listas_de_definiciones_compactas
Activa la sintaxis de la lista de definiciones de pandoc 1.12.x y versiones anteriores. Esta sintaxis difiere
del descrito anteriormente en Definición enumera en varios aspectos:
· No se requiere línea en blanco entre elementos consecutivos de la lista de definición.
· Para obtener una lista "ajustada" o "compacta", omita el espacio entre elementos consecutivos; el espacio
entre un término y su definición no afecta nada.
· No se permite el ajuste perezoso de párrafos: toda la definición debe tener una sangría de cuatro
espacios
Reducción variantes
Además del Markdown extendido de pandoc, se admiten las siguientes variantes de Markdown:
markdown_phpextra (PHP Reducción adicionales)
notas al pie, pipe_tables, raw_html, markdown_attribute, fenced_code_blocks,
listas_definiciones, guiones bajos intrapalabras, atributos_encabezado, atributos_enlace,
abreviaturas, acceso directo_referencia_enlaces.
markdown_github (Con sabor a GitHub Reducción)
pipe_tables, raw_html, tex_math_single_backslash, cercado_código_bloques,
auto_identificadores, ascii_identifiers, backtick_code_blocks, autolink_bare_uris,
intraword_underscores, tachado, hard_line_breaks, emoji,
acceso directo_referencia_enlaces.
rebajas_mmd (Rebajas múltiples)
pipe_tables raw_html, markdown_attribute, mmd_link_attributes, raw_tex,
tex_math_double_backslash, intraword_underscores, mmd_title_block, notas al pie,
listas_de_definición, todos_los_símbolos_escapables, referencias_de_cabecera_implícitas,
auto_identificadores, mmd_header_identifiers, acceso directo_referencia_enlaces.
rebajas_estrictas (Markdown.pl)
raw_html
Prórrogas de tiempo para presentar declaraciones de impuestos con formatos other than Reducción
Algunas de las extensiones discutidas anteriormente se pueden usar con formatos distintos de Markdown:
· Los auto_identificadores se pueden usar con entrada de látex, rst, mediawiki y textil (y se usa
por defecto).
· Se pueden usar tex_math_dollars, tex_math_single_backslash y tex_math_double_backslash
con entrada html. (Esto es útil para leer páginas web formateadas usando MathJax, por
ejemplo.)
PRODUCTOR DESLICE SHOWS CON PANDOC
Puede usar pandoc para producir una presentación de diapositivas HTML + javascript que se puede ver
a través de un navegador web. Hay cinco formas de hacer esto, usando S5, DZSlides, Slidy, Slideous,
o revelar.js. También puede producir una presentación de diapositivas en PDF utilizando el proyector LaTeX.
Aquí está la fuente de Markdown para una presentación de diapositivas simple, habits.txt:
% Hábitos
% Juan Pérez
% 22 de marzo de 2005
# Por la mañana
## Levantando
- Desactivar alarma
- Levantarse de la cama
## Desayuno
- Comer huevos
- Beber café
# Por la tarde
## Cena
- Comer espaguetis
- Beber vino
------------------
## Ir a dormir
- Métete en la cama
- Contar ovejas
Para producir una presentación de diapositivas HTML/javascript, simplemente escriba
pandoc -t FORMATO -s hábitos.txt -o hábitos.html
donde FORMATO es s5, slidy, slideous, dzslides o allowjs.
Para Slidy, Slideous, revela.js y S5, el archivo producido por pandoc con el
-s/--opción independiente incrusta un enlace a javascripts y archivos CSS, que se supone que son
disponible en la ruta relativa s5/default (para S5), slideous (para Slideous), revela.js
(para revelar.js), o en el sitio web de Slidy en w3.org (para Slidy). (Estos caminos pueden ser
cambiado configurando las variables slidy-url, slideous-url, allowjs-url o s5-url; ver
Variables para diapositivas, arriba.) Para DZSlides, el (relativamente corto) javascript y css son
incluido en el archivo por defecto.
Con todos los formatos de diapositivas HTML, la opción --self-contained se puede usar para producir una sola
archivo que contiene todos los datos necesarios para mostrar la presentación de diapositivas, incluidos los enlaces
scripts, hojas de estilo, imágenes y videos.
Para producir una presentación de diapositivas en PDF usando el proyector, escriba
pandoc -t beamer hábitos.txt -o hábitos.pdf
Tenga en cuenta que una presentación de diapositivas de unlock.js también se puede convertir a PDF imprimiéndola en un archivo
desde el navegador.
Estructurar los diapositiva show
Por defecto, el diapositiva nivel es el nivel de encabezado más alto en la jerarquía que se sigue
inmediatamente por contenido, y no por otro encabezado, en algún lugar del documento. en el ejemplo
arriba, los encabezados de nivel 1 siempre van seguidos de los encabezados de nivel 2, que van seguidos de
contenido, por lo que 2 es el nivel de la diapositiva. Este valor predeterminado se puede anular utilizando --slide-level
.
El documento se divide en diapositivas de acuerdo con las siguientes reglas:
· Una regla horizontal siempre inicia una nueva diapositiva.
· Un encabezado en el nivel de diapositiva siempre inicia una nueva diapositiva.
· Cabeceras below el nivel de diapositiva en la jerarquía crear encabezados within una diapositiva.
· Cabeceras above el nivel de diapositiva en la jerarquía crea "diapositivas de título", que solo contienen
el título de la sección y ayudar a dividir la presentación de diapositivas en secciones.
· Una página de título se construye automáticamente a partir del bloque de título del documento, si está presente.
(En el caso de beamer, esto se puede deshabilitar comentando algunas líneas en el predeterminado
modelo.)
Estas reglas están diseñadas para admitir muchos estilos diferentes de presentación de diapositivas. si no lo haces
Preocúpate por estructurar tus diapositivas en secciones y subsecciones, solo puedes usar el nivel 1
encabezados para todas las diapositivas. (En ese caso, el nivel 1 será el nivel de la diapositiva.) Pero puede
también estructure la presentación de diapositivas en secciones, como en el ejemplo anterior.
Nota: en las presentaciones de diapositivas deReveal.js, si el nivel de la diapositiva es 2, se mostrará un diseño bidimensional.
producidos, con encabezados de nivel 1 que se construyen horizontalmente y encabezados de nivel 2 que se construyen
verticalmente No se recomienda utilizar anidamientos más profundos de niveles de sección con
revelar.js.
Incremental liza
De forma predeterminada, estos escritores producen listas que muestran "todos a la vez". Si quieres tus listas
para mostrar de forma incremental (un elemento a la vez), utilice la opción -i. si quieres un
lista particular para salir del valor predeterminado (es decir, para mostrar de forma incremental sin la
-i y todo a la vez con la opción -i), póngalo entre comillas:
> - Comer espaguetis
> - Beber vino
De esta manera, las listas incrementales y no incrementales se pueden mezclar en un solo documento.
Inserción descansos
Puede agregar "pausas" dentro de una diapositiva al incluir un párrafo que contenga tres puntos,
separados por espacios:
# Diapositiva con una pausa
contenido antes de la pausa
. . .
contenido después de la pausa
Estilismo los diapositivas
Puede cambiar el estilo de las diapositivas HTML colocando archivos CSS personalizados en
$DATADIR/s5/predeterminado (para S5), $DATADIR/slidy (para Slidy) o $DATADIR/slideous (para
Slideous), donde $DATADIR es el directorio de datos del usuario (ver --data-dir, arriba). El
los originales se pueden encontrar en el directorio de datos del sistema de pandoc (generalmente
$CABALDIR/pandoc-VERSION/s5/default). Pandoc buscará allí cualquier archivo que no
encontrar en el directorio de datos de usuario.
Para dzslides, el CSS se incluye en el propio archivo HTML y se puede modificar allí.
Todas las opciones de configuración deReveal.js se pueden configurar a través de variables. Por ejemplo, los temas pueden
ser utilizado configurando la variable del tema:
-V tema=luna
O puede especificar una hoja de estilo personalizada usando la opción --css.
Para aplicar estilo a las diapositivas del proyector, puede especificar un tema, un tema de color, un tema de fuente, un tema interno y
tema externo, usando la opción -V:
pandoc -t beamer hábitos.txt -V tema:Varsovia -o hábitos.pdf
Tenga en cuenta que los atributos de encabezado se convertirán en atributos de diapositiva (en un o ) en
Formatos de diapositivas HTML, lo que le permite diseñar diapositivas individuales. En beamer, el único encabezado
El atributo que afecta a las diapositivas es la clase allowframebreaks, que establece el
opción allowframebreaks, lo que hace que se creen múltiples diapositivas si el contenido se desborda
el marco. Esto se recomienda especialmente para bibliografías:
# Referencias {.allowframebreaks}
Ponentes reconoce
revelar.js tiene un buen soporte para las notas del orador. Puede agregar notas a su documento Markdown
así:
Esta es mi nota.
- Puede contener Markdown
- como esta lista
</div>
Para mostrar la ventana de notas, presione s mientras ve la presentación. Las notas aún no están
compatible con otros formatos de diapositivas, pero las notas no aparecerán en las diapositivas.
Cuadro atributos in beamer
A veces es necesario agregar la opción LaTeX [frágil] a un marco en beamer (por
ejemplo, cuando se usa el entorno acuñado). Esto se puede forzar agregando el frágil
class al encabezado que presenta la diapositiva:
# Tobogán frágil {.frágil}
Todos los demás atributos del marco descritos en la Sección 8.1 de la Guía del usuario del proyector pueden
también se puede usar: allowdisplaybreaks, allowframebreaks, b, c, t, environment, label, plain,
encogimiento.
CREANDO EPUB CON PANDOC
EPUB metadatos
Los metadatos EPUB se pueden especificar usando la opción --epub-metadata, pero si la fuente
documento es Markdown, es mejor usar un bloque de metadatos YAML. Aquí hay un ejemplo:
. . .
título:
- tipo: principal
texto: Mi libro
- tipo: subtítulo
texto: Una investigación de metadatos
creador:
- papel: autor
texto: Juan Smith
- papel: redactor
texto: Sara Jones
identificador:
- esquema: DOI
texto: doi:10.234234.234/33
editor: mi prensa
derechos: © 2007 John Smith, CC BY-NC
...
Se reconocen los siguientes campos:
identificador
Ya sea un valor de cadena o un objeto con campos de texto y esquema. Valores válidos para
esquema son ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
Número de depósito legal, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.
título Ya sea un valor de cadena, o un objeto con campos como archivo y tipo, o una lista de tales
objetos. Los valores válidos para el tipo son principal, subtítulo, corto, colección, edición,
extendido.
creador
Ya sea un valor de cadena, un objeto con función de campos, archivo como y texto, o una lista
de tales objetos. Los valores válidos para el rol son relatores MARC, pero pandoc intentará
para traducir las versiones legibles por humanos (como "autor" y "editor") al
relatores de marcas apropiados.
contribuyente
Mismo formato que el creador.
datos Un valor de cadena en formato AAAA-MM-DD. (Solo es necesario el año). Pandoc
intente convertir otros formatos de fecha comunes.
lang (o legado: idioma)
Un valor de cadena en formato BCP 47. Pandoc usará por defecto el idioma local si
no se especifica nada.
sujeto
Un valor de cadena o una lista de dichos valores.
descripción
Un valor de cadena.
tipo Un valor de cadena.
formato Un valor de cadena.
relación
Un valor de cadena.
cobertura
Un valor de cadena.
derechos Un valor de cadena.
Imagen de portada
Un valor de cadena (ruta a la imagen de portada).
Hoja de estilo
Un valor de cadena (ruta a la hoja de estilo CSS).
página-progresión-dirección
Ya sea ltr o rtl. Especifica el atributo de dirección de progresión de la página para el
elemento de la columna vertebral
Vinculado medios de comunicación
De manera predeterminada, pandoc descargará los medios vinculados (incluidos audio y video) y los incluirá
en el contenedor EPUB, produciendo un EPUB completamente autónomo. Si desea vincular a
recursos de medios externos en su lugar, use HTML sin procesar en su fuente y agregue data-external="1" a
la etiqueta con el atributo src. Por ejemplo:
<fuente src="/http://example.com/music/toccata.mp3"
datos-externo="1" tipo="audio/mpeg">
ALFABETIZADO Haskell SOPORTE
Si agrega +lhs (o +literate_haskell) a un formato de entrada o salida apropiado
(markdown, markdown_strict, rst o latex para entrada o salida; beamer, html o html5 para
salida solamente), pandoc tratará el documento como fuente alfabetizada de Haskell. Esto significa que
· En la entrada de Markdown, las secciones de "huellas de pájaros" se analizarán como código Haskell en lugar de
cotizaciones en bloque. El texto entre \begin{code} y \end{code} también se tratará como
código Haskell. Para los encabezados de estilo ATX, se utilizará el carácter '=' en lugar de '#'.
· En la salida de Markdown, los bloques de código con las clases haskell y literate se representarán usando
las huellas de pájaros y las citas en bloque se sangrarán un espacio, por lo que no serán
tratado como código Haskell. Además, los encabezados se representarán al estilo setext (con
subrayados) en lugar del estilo ATX (con caracteres '#'). (Esto se debe a que ghc trata
caracteres '#' en la columna 1 como introducción de números de línea).
· En la entrada de texto reestructurada, las secciones de "huella de pájaro" se analizarán como código Haskell.
· En la salida de texto reestructurado, los bloques de código con la clase haskell se representarán mediante bird
pistas.
· En la entrada de LaTeX, el texto en entornos de código se analizará como código Haskell.
· En la salida de LaTeX, los bloques de código con la clase haskell se representarán dentro del código
.
· En la salida HTML, los bloques de código con clase haskell se representarán con clase
alfabetizadohaskell y huellas de aves.
Ejemplos:
pandoc -f rebaja+lhs -t html
lee fuentes alfabetizadas de Haskell formateadas con las convenciones de Markdown y escribe HTML ordinario
(sin huellas de pájaros).
pandoc -f rebaja+lhs -t html+lhs
escribe HTML con el código Haskell en huellas de pájaros, por lo que se puede copiar y pegar como
fuente alfabetizada de Haskell.
SINTAXIS DESTACAR
Pandoc resaltará automáticamente la sintaxis en bloques de código delimitados que están marcados con un
Nombre del lenguaje. La biblioteca de Haskell resaltando-kate se utiliza para resaltar, que
funciona en salida HTML, Docx y LaTeX/PDF. El esquema de color se puede seleccionar usando el
--opción de estilo resaltado. El esquema de color predeterminado es pygments, que imita el
esquema de color predeterminado utilizado por los pigmentos de la biblioteca de Python, pero los pigmentos no son en realidad
solía hacer el resaltado.
Para ver una lista de nombres de idiomas que pandoc reconocerá, escriba pandoc --version.
Para deshabilitar el resaltado, use la opción --no-highlight.
PERSONALIZADO ESCRITORES
Pandoc se puede ampliar con escritores personalizados escritos en lua. (Pandoc incluye un lua
intérprete, por lo que lua no necesita instalarse por separado).
Para usar un escritor personalizado, simplemente especifique la ruta al script lua en lugar de la salida
formato. Por ejemplo:
pandoc -t datos/muestra.lua
La creación de un escritor personalizado requiere escribir una función lua para cada elemento posible en un
documento pandoc. Para obtener un ejemplo documentado que puede modificar de acuerdo con su
necesidades, hacer
pandoc --print-default-data-file muestra.lua
AUTORES
© 2006-2015 John MacFarlane ([email protected]). Publicado bajo la GPL, versión 2 o
mayor que. Este software no tiene garantía de ningún tipo. (Ver DERECHOS DE AUTOR para
avisos de derechos de autor y garantía).
Los colaboradores incluyen a Aaron Wolen, Albert Krewinkel, Alexander Kondratskiy, Alexander
Sulfrian, Alexander V Vershilov, Alfred Wechselberger, Andreas Lööw, Andrew Dunning,
Antoine Latter, Arata Mizuki, Arlo O'Keeffe, Artyom Kazak, Ben Gamari, Beni
Cherniavsky-Paskin, Bjorn Buckwalter, Bradley Kuhn, Brent Yorgey, Bryan O'Sullivan, B.
Scott Michel, Caleb McDaniel, Calvin Beck, Christoffer Ackelman, Christoffer Sawicki,
Clare Macrae, Clint Adams, Conal Elliott, Craig S. Bosma, Daniel Bergey, Daniel T.
Staal, David Lazar, David Röthlisberger, Denis Laxalde, Douglas Calvert, Douglas F.
Calvert, Eric Kow, Eric Seidel, Florian Eitel, François Gannaz, Freiric Barral, Fyodor
Sheremetyev, Gabor Pali, Gavin Beatty, Greg Maslov, Grégory Bataille, Greg Rundlett,
gwern, Gwern Branwen, Hans-Peter Deifel, Henry de Valence, Ilya V. Portnov, infinity0x,
Jaime Marquínez Ferrándiz, James Aspnes, Jamie F. Olson, Jan Larres, Jason Ronallo, Jeff
Arnold, Jeff Runningen, Jens Petersen, Jérémy Bobbio, Jesse Rosenthal, J. Lewis Muir, Joe
Hillenbrand, John MacFarlane, Jonas Smedegaard, Jonathan Daugherty, Josef Svenningsson,
José Luis Durán, Julien Cretel, Justin Bogner, Kelsey Hightower, Konstantin Zudov,
Lars-Dominik Braun, Luke Plant, Mark Szepieniec, Mark Wright, Masayoshi Takahashi, Matej
Kollar, Mathias Schenner, Matthew Pickering, Matthias CM Troffaes, Mauro Bieg, Max
Bolingbroke, Max Rydahl Andersen, Merijn Verstraaten, Michael Snoyman, Michael Thompson,
MinRK, Nathan Gass, Neil Mayhew, Nick Bart, Nicolas Kaiser, Nikolay Yakimov, nkalvi, Paulo
Tanimoto, Paul Rivier, Peter Wang, Philippe Ombredanne, Phillip Alday, Puneeth Chaganti,
qerub, Ralf Stephan, Recai Oktaş, rodja.trappe, RyanGlScott, Scott Morrison, Sergei
Trofimovich, Sergey Astanin, Shahbaz Youssefi, Shaun Attfield, shreevatsa.public, Simon
Hengel, Sumit Sahrawat, takahashim, thsutton, Tim Lin, Timothy Humphries, Todd Sifleet,
Tom Leese, Uli Köhler, Václav Zeman, Viktor Kronvall, Vincent, Wikiwide y Xavier Olive.
El código fuente de Pandoc y toda la documentación se pueden descargar dehttp://pandoc.org>.
Use pandoc en línea usando los servicios de onworks.net
