Come faccio a fare riferimento a una figura in markdown usando pandoc?

Question

Attualmente sto scrivendo un documento in markdown e mi piacerebbe fare riferimento ad un'immagine dal mio testo.

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

![image1](img/image1.png) 

voglio farlo di riferimento, perché dopo la conversione mia Markdown in pdf, le immagini vengono inseriti in una o due pagine dopo e il documento non ha alcun senso.

UPDATE:

Ho provato Ryan's answer in that post e non riesco a farlo 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} doesn' t apparire: no riferimento è stato creato.
• (\autoref{image}) diventa \href{\#image}{image}: non viene rilevato alcun riferimento incrociato.

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

Qualsiasi aiuto sarebbe molto apprezzato !!

Answer 1

In Pandoc si può anche fare:

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

Answer 2

Ho avuto una conversazione con Ryan Gray dopo aver letto his answer in un post simile. In realtà la sua soluzione di utilizzo:

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

si adatta solo quando si utilizza multimarkdown.

Quando si tratta di Pandoc, l'unica soluzione per fare riferimenti incrociati sta utilizzando lattice direttamente parole chiave:

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

Answer 3

Pandoc supporta riferimento sezioni (via section identifiers con prefisso #).

Commenti su questo open issue descrivono come la seguente soluzione sfrutta sezione identificatori per generare i riferimenti di immagine 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). 

è richiesto La linea vuota prima </div>.

Answer 4

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

Aggiungere un'etichetta agli attributi dell'immagine come questo:

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

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

@fig:description 

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

Answer 5

Supponendo che si desidera output PDF di Pandoc alla fine:

La migliore soluzione per l'inserimento di immagini e cambiando 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.latex ho:

\usepackage{wrapfig} 
\usepackage{float} 

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

In caso di Matplotlib è consigliabile esportare in PDF e quindi utilizzare il codice che ho postato. Ciò garantirà 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.