Drop plainify, document multi-line captions

Author: agriyakhetarpal

layouts/shortcodes/figure.html

@@ -27,6 +27,31 @@
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
 
+{{< figure
+    src="https://images.unsplash.com/photo-1546238232-20216dec9f72"
+    alt="Cute puppies"
+    attribution="Figure Credits: Cute puppies image from unsplash.com"
+    attributionlink="https://images.unsplash.com/photo-1546238232-20216dec9f72"
+    align="right"
+    height=150
+    width=300
+    caption="A figure with right alignment."
+>}}
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+{{< figure
+    src="https://images.unsplash.com/photo-1546238232-20216dec9f72"
+    alt="Cute puppies"
+    height=200
+    width=400
+    attribution="Figure Credits: Cute puppies image from unsplash.com"
+    attributionlink="https://images.unsplash.com/photo-1546238232-20216dec9f72"
+    caption="A figure with a caption split across multiple lines with `<br>` tags.<br><br>You can use **Markdown** _formatting_ within the caption text and use it to fit the needs of your content.<br>As always, be sure to credit the image source!"
+>}}
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
 
 */}}
@@ -52,7 +77,7 @@
 {{- with $figure.attributionlink -}}<a href="{{ . }}">{{- end -}}{{- $figure.attribution -}}{{- if $figure.attributionlink -}}</a>{{- end -}}
 {{- end }}
 <p><span class="caption-text">
-{{- $figure.caption | markdownify | plainify -}}
+{{- $figure.caption | markdownify -}}
 </span>
 {{- with $figure.legend }}
 <div class="legend">