From a323b7e3841fbe8792c386b46627b61bdd44bf53 Mon Sep 17 00:00:00 2001
From: Christian Bager Bach Houmann <christian@bagerbach.com>
Date: Wed, 14 Feb 2024 21:17:22 +0100
Subject: [PATCH] docs: document cursor insert after feature

---
 docs/docs/Choices/CaptureChoice.md | 53 +++++++++++++++++++++---------
 1 file changed, 37 insertions(+), 16 deletions(-)

diff --git a/docs/docs/Choices/CaptureChoice.md b/docs/docs/Choices/CaptureChoice.md
index cd3146c..9f4b579 100644
--- a/docs/docs/Choices/CaptureChoice.md
+++ b/docs/docs/Choices/CaptureChoice.md
@@ -1,16 +1,18 @@
 ---
 title: Capture
 ---
+
 Allows to quickly capture your input and save it from anywhere in Obsidian, without leaving your current window setup e.g.
-- Add messages to your work log
-- Save interesting links for later reading and watching
-- Individually timed notes in Daily notes file
 
+-   Add messages to your work log
+-   Save interesting links for later reading and watching
+-   Individually timed notes in Daily notes file
 
 ![image](https://user-images.githubusercontent.com/29108628/123451366-e025e280-d5dd-11eb-81b6-c21f3ad1823d.png)
 ![image](https://user-images.githubusercontent.com/29108628/123451469-e61bc380-d5dd-11eb-80d1-7667427656f3.png)
 
 ## Capture To
+
 _Capture To_ is the name of the file you are capturing to.
 You can choose to either enable _Capture to active file_, or you can enter a file name in the _File Name_ input field.
 
@@ -19,6 +21,7 @@ I have one for my daily journal with the name `bins/daily/{{DATE:gggg-MM-DD - dd
 This automatically finds the file for the day, and whatever I enter will be captured to it.
 
 ### Capturing to folders
+
 You can also type a **folder name** into the _Capture To_ field, and QuickAdd will ask you which file in the folder you'd like to capture to.
 This also supports the [format syntax](/FormatSyntax.md). You can even write a filename in the suggester that opens, and it will create the file for you - assuming you have the _Create file if it doesn't exist_ setting enabled.
 
@@ -29,18 +32,20 @@ You could also write nothing - or `/` - in the _Capture To_ field. This will ope
 Capturing to a folder will show all files in that folder. This means that files in nested folders will also appear.
 
 ### Capturing to tags
+
 Similarly, you can type a **tag name** in the _Capture To_ field, and QuickAdd will ask you which file to capture to, assuming the file has the tag you specify.
 
 If you have a tag called `#people`, and you type `#people` in the _Capture To_ field, QuickAdd will ask you which file to capture to, assuming the file has the `#people` tag.
 
-
 ## Capture Options
+
 -   _Create file if it doesn't exist_ will do as the name implies - you can also create the file from a template, if you specify the template (the input box will appear below the setting).
 -   _Task_ will format your captured text as a task.
 -   _Write to bottom of file_ will put whatever you enter at the bottom of the file.
 -   _Append link_ will append a link to the file you have open in the file you're capturing to.
 
 ## Insert after
+
 Insert After will allow you to insert the text after some line with the specified text.
 
 With Insert After, you can also enable `Insert at end of section` and `Consider subsections`.
@@ -48,43 +53,59 @@ You can see an explanation of these below.
 
 I use this in my daily journal capture, where I insert after the heading line `## What did I do today?`.
 
+It's also possible to use `Create line if not found`, which will create the line if it doesn't exist. This is useful if you want to insert after a line that might not exist in the file you're capturing to.
+This setting can place the line at the start or end of the file, or at your current cursor position.
+
 ### Consider subsections -option
+
 #### `Consider subsections` disabled
+
 Behavior with `Insert after` & `Insert at end`:
+
 ```markdown
-## 1. First heading 
+## 1. First heading
+
 **Insert after** comes here.
-- content 1
-- content 2
-- content 3 
-**Insert at end** comes here.
+
+-   content 1
+-   content 2
+-   content 3
+    **Insert at end** comes here.
 
 ### 1.1. Nested heading 1
+
 Content
 
 ## 2. Another heading
-Content
 
+Content
 ```
+
 #### `Consider subsections` enabled
+
 Behavior with `Insert after` & `Insert at end`:
+
 ```markdown
-## 1. First heading 		
+## 1. First heading
+
 **Insert after** comes here
-- content 1
-- content 2
-- content 3
+
+-   content 1
+-   content 2
+-   content 3
 
 ### 1.1. Nested heading 1
-Content 		
+
+Content
 **Insert at end** comes here. Captures to after this, as it's considered part of the "1. First heading" section.
 
 ## 2. Another heading
-Content
 
+Content
 ```
 
 ## Capture Format
+
 Capture format lets you specify the exact format that you want what you're capturing to be inserted as.
 You can do practically anything here. Think of it as a mini template.