Come faccio a fare riferimento a una cifra in markdown utilizzando pandoc?

Attualmente sto scrivendo un documento in markdown e vorrei fare un riferimento a un'immagine dal mio testo.

this is my text, I want a reference to my image1 [here]. blablabla

![image1](img/image1.png)

Voglio fare quel riferimento perché dopo aver convertito il mio markdown in pdf, le immagini vengono inserite in una o due pagine dopo e il documento non ha alcun senso.

AGGIORNARE:

Ho provato la risposta di Ryan in quel post e non riesco a farla funzionare. A quanto pare il codice:

[image]: image.png "Image Title" 
![Alt text][image] 
A reference to the [image](#image).

dovrebbe produrre:

\begin{figure}[htbp] 
\centering 
\includegraphics[keepaspectratio,width=\textwidth,height=0.75\textheight]{i mage.png} 
\caption{Alt text} 
\label{image} 
\end{figure} 

A reference to the image (\autoref{image}).

invece ottengo:

\begin{figure}[htbp]
\centering
\includegraphics{image.png}
\caption{Alt text}
\end{figure}

A reference to the \href{\#image}{image}.

Ho notato due problemi:

• \label{image} non appare: non viene creato alcun riferimento.
• (\autoref{image})diventa \href{\#image}{image}: non viene rilevato alcun riferimento incrociato.

E poi, quando lo converto in pdf, ovviamente non si collega all'immagine. C'è un collegamento, ma non si collega a nulla.

Qualsiasi aiuto sarebbe molto apprezzato!!

In pandoc puoi persino fare:

![This is the caption\label{mylabel}](/url/of/image.png)
See figure \ref{mylabel}.

È possibile utilizzare il filtro pandoc-fignos per la numerazione e il riferimento delle figure. Funziona con qualsiasi formato di output, non solo LaTeX.

Aggiungi un'etichetta agli attributi dell'immagine in questo modo:

 ![Caption.](image.png) {#fig:description}

... e quindi fai riferimento alla figura in questo modo:

 @fig:description

Le informazioni su come installare e applicare il filtro pandoc-fignos sono fornite sulla sua pagina Web. C'è anche il filtro pandoc-eqnos per fare lo stesso tipo di cose con le equazioni.

Ho fatto una chiacchierata con Ryan Gray dopo aver letto la sua risposta in un post simile. In realtà la sua soluzione di usare:

[image]: image.png "Image Title" 
![Alt text][image] 
A reference to the [image](#image).

viene adattato solo quando si utilizza il multimarkdown.

Quando si tratta di pandoc, l'unica soluzione per fare riferimenti incrociati è utilizzare direttamente parole chiave in latex:

[image]: image.png "Image Title"
![Alt text \label{mylabel}][image]
See figure \ref{mylabel}.

Pandoc supporta le sezioni di riferimento (tramite identificatori di sezione preceduti da #).

I commenti su questo problema aperto descrivono come la seguente soluzione alternativa sfrutta gli identificatori di sezione per generare riferimenti a immagini in LaTeX e HTML:

<div id="fig:lalune">
![A voyage to the moon\label{fig:lalune}](lalune.jpg)

</div>

[The voyage to the moon](#fig:lalune).

La riga vuota prima </div>è obbligatoria.

Supponendo che tu voglia l'output PDF di Pandoc alla fine:

La soluzione migliore per inserire immagini e modificare i loro attributi che ho trovato è:

\begin{figure}[H]
\includegraphics[width=0.25\textwidth, height=!]{images/path.png}
\centering
\caption{mycaption}
\end{figure}

e nel mio template.latexho:

\usepackage{wrapfig}
\usepackage{float}

Altre soluzioni non possono specificare la larghezza o l'altezza dell'immagine, almeno non nel markdown standard. Tuttavia è spesso essenziale che qualcosa come un libro o un foglio specifichi le dimensioni delle figure, tranne per il fatto che si desidera configurare le dimensioni di output delle immagini prima di utilizzarle nel documento. In tal caso dovresti gestire impostazioni diverse per quegli strumenti che usi per creare le immagini.

Consiglio in caso di Matplotlib di esportare in PDF e poi utilizzare il codice che ho postato. Ciò fornirà la migliore qualità dell'immagine e la massima flessibilità nella configurazione di come apparirà l'immagine nel PDF di output, senza doversi preoccupare di cose.

Con pandoc-crossref puoi incrociare figure di riferimento con la seguente sintassi:

![Caption](file.ext){#fig:label}

Quindi fai riferimento alla figura nel testo in modo simile alla sintassi della citazione [@fig:label]e compila con --filter pandoc-crossref(deve venire prima --filter pandoc-citeprocse stai usando anche quella).

Puoi controllare lo styling con ad esempio \usepackage[font=small,labelfont=bf]{caption}in header-includes.

Un bel trucco correlato se usi \listoffiguresin latex, è questo lua-filter , che ti consente di impostare un titolo breve invece di avere l'intera legenda della figura mostrata nell'elenco delle figure:

![Caption](file.ext){#fig:label short-caption='my short caption'}

quindi compilare con --lua-filter short-captions.lua.