search

zcash / zips

Zcash Improvement Proposals
https://zips.z.cash
MIT License
274 stars 156 forks source link

References are duplicated in the rendering of Markdown ZIPs #893

Open daira opened 3 months ago

daira commented 3 months ago

E.g. image

This is because we are abusing footnotes to implement references. Perhaps we should use mdbook to render the Markdown ZIPs, as long as we can get that to fit in nicely with the rendering of the reStructuredText ZIPs.

daira commented 1 week ago

This has been an open bug on Pandoc for 10 years (https://github.com/jgm/pandoc/issues/1603), but MultiMarkdown has fixed it. In #953 there is some preparation for switching to MultiMarkdown; you can try this out using

make MARKDOWN_OPTION=--mmd

You will need the multimarkdown executable on the PATH. (On Linux you'll need to compile it from source.)