有几个网站提供了合理的表格和图像备忘单或 HOWTO。我的名单上最重要的是:
图片使用起来非常简单,但不提供调整图像以适合页面的功能(请参阅Update, 以下)。要调整图像属性(大小、分辨率、颜色、边框等),您需要某种形式的图像编辑器。我发现我可以用其中之一做我需要做的一切图像魔术师, GIMP, or InkScape,全部免费且开源。
要添加图片,请使用:
![Caption for the picture.](/path/to/image.png)
我知道 pandoc 支持 PNG 和 JPG,这应该可以满足您的大部分需求。
如果您在 R 中创建图像(例如绘图),则可以控制图像大小。这可以直接在创建图像的命令中完成,或者更好的是,如果您使用的是选项,则可以通过选项完成knitr(强烈推荐...查看块选项,特别是在图下)。
我强烈建议仔细阅读这些教程; Markdown 非常方便,并且有许多功能,大多数人不经常使用,但一旦学会就会非常喜欢。 (SO 不一定是提出这些教程中直接回答的问题的最佳场所。)
更新,2019 年 8 月 31 日
前一段时间,pandoc
合并了图像的“link_attributes”(显然是在 2015 年,提交jgm/pandoc#244cd56)。 “调整图像大小”可以直接完成。例如:
![unchanged image](foo.jpg)
![much-smaller image](foo.jpg){#id .class width=30 height=20px}
![half-size image](foo.jpg){#id .class width=50% height=50%}
尺寸可以不带单位(假设为像素),也可以不带单位"px
, cm
, mm
, in
, inch
and %
" (ref: https://pandoc.org/MANUAL.html, 搜索link_attributes
).
(我不确定 CommonMark 是否已经实现了这一点,尽管有一个冗长的讨论.)