feat: dont show image in post

_layouts/post.html

@@ -36,7 +36,7 @@ <h1 data-toc-skip>{{ page.title }}</h1>
         </span>
       {% endif %}
 
-      {% if page.image %}
+      {% if page.image and page.image.post != false %}
         {% capture src %}src="{{ page.image.path | default: page.image }}"{% endcapture %}
         {% capture class %}class="preview-img{% if page.image.no_bg %}{{ ' no-bg' }}{% endif %}"{% endcapture %}
         {% capture alt %}alt="{{ page.image.alt | xml_escape | default: "Preview Image" }}"{% endcapture %}

_posts/2019-08-08-write-a-new-post.md

@@ -95,6 +95,29 @@ toc: false
 ---
 ```
 
+## Image
+
+To add an image to the post so that it shows on the preview, embeds, and beginning of the post itself, you can specify the `image` field in the _Front Matter_ as follows:
+
+```yaml
+---
+image: 
+  path: /path/to/image.jpeg
+  alt: this is some alt text
+---
+```
+
+You can also use the `post` subfield if you only want the image to show up in the preview and embeds, and _not_ in the post.
+
+```yaml
+---
+image: 
+  path: /path/to/image.jpeg
+  alt: this is some alt text
+  post: false
+---
+```
+
 ## Comments
 
 The global setting for comments is defined by the `comments.provider` option in the `_config.yml`{: .filepath} file. Once a comment system is selected for this variable, comments will be enabled for all posts.