Convierta enlaces de Markdown a HTML con Pandoc

Question 1

En mi nuevo proyecto tengo varios archivos Markdown que están vinculados entre sí. Estos enlaces se refieren al original. .md archivos

Ejemplo:

Archivo LÉAME.md

...
1. [Development documentation](Development.md)
1. [User documentation](Usage.md)
...

Si convierto estos archivos con Pandoc, por ejemplo, a archivos HTML, todos los enlaces siguen apuntando al original .md archivo. Estoy buscando una manera de convertir también el tipo de enlace, lo que significa que los archivos de salida deben hacer referencia al tipo de archivo de salida, como HTML, PDF, Texasetc. ¿Hay alguna forma de convertir el tipo de enlace interno con Pandoc?

Yo uso esto para convertir los archivos:

pandoc -f markdown -t html5 input.md -o output.html

Question 2

Ejemplo con el filtros Lua incorporados:

-- links-to-html.lua
function Link(el)
  el.target = string.gsub(el.target, "%.md", ".html")
  return el
end

Entonces:

pandoc -f markdown -t html5 input.md -o output.html --lua-filter=links-to-html.lua

Question 3

Puede crear un filtro que verifique cada enlace elemento y—si la URL termina con .md—lo reemplaza por .html.

Ejemplo con Python, usando el flauta de pan paquete:

import panflute as pf

def action(elem, doc):
    if isinstance(elem, pf.Link) and elem.url.endswith('.md'):
        elem.url = elem.url[:-3] + '.html'
        return elem

if __name__ == '__main__':
    pf.run_filter(action)

Question 4

Suponiendo que va a servirle páginas HTML a través de un servidor web, es relativamente simple resolver todos *.md URL como *.html en lugar de reescribirlos a través de Pandoc, por ejemplo, usando Nginx:

location ~ \.md$ {
  if (!-f $request_filename) {
    rewrite ^(.*)\.md$ $1 permanent;
  }
}

location / {
  try_files /$uri /$uri.html;
}

Alternativamente, puede reemplazar todos md enlaces con html usando sed
(tomado de aquí):

Cambie todas las URL de archivos internos para que no apunten a enlaces *.md y, en su lugar, apunten al archivo local *.html
ejecute recursivamente este comando sed (reemplace programáticamente NOMBRE DE ARCHIVO)
sed -n -i.bak '/href="\./s/\.md/\.html/' FILENAME.html
alternativamente, ejecute el siguiente comando en su lugar (reemplace programáticamente NOMBRE DE ARCHIVO)
sed -e '/href="\./s/\.md/\.html/' FILENAME.html > FILENAME.html.tmp && mv FILENAME.html.tmp FILENAME.html`

Question 5

Una ligera modificación a la respuesta de Sergio Correia también capta enlaces de anclaje en documentos. Cuidarse; en algunos casos raros, esto podría distorsionar los enlaces…

import panflute as pf

def action(elem, doc):
    if isinstance(elem, pf.Link):
        if elem.url.endswith('.md'):
            elem.url = elem.url[:-3] + '.html'
            return elem
        elif elem.url.find('.md#'):
            elem.url = elem.url.replace('.md#', '.html#')
            return elem

if __name__ == '__main__':
    pf.run_filter(action)

Question 6

Tuve un problema similar, así que hice md_htmldoc.

encuentra todos los .md archivos en un directorio y luego crea un directorio separado donde todos los archivos Markdown se han convertido a HTML.

Corrige hipervínculos (gracias a la respuesta de Sergio Correia).

También recopila las referencias de archivos locales para que los enlaces a las imágenes y demás sigan funcionando.

Question 7

Para cualquiera que use un Makefile para impulsar la conversión, aquí hay un fragmento de Makefile que proporciona una regla que transforma un .md en un .html con el enlace ajustado:

SHELL=/bin/bash

%.html: %.md
    ( set -eu -o pipefail ; \
    pandoc -i $< -t html | \
    sed -E 's/<a href="([^"]*).md/<a href="\1.html/g' > $@.tmp && mv -vf $@.tmp $@ ; )

Si test.md existe en el directorio actual, make test.html lo haré.

La regla también se encarga de no aplastar un archivo HTML existente (cualquiera que sea el motivo) hasta que la conversión realmente se realice correctamente.

¿Ha sido útil esta solución?