st3v3nmw · st3v3nmw · Aug 25, 2024 · Aug 15, 2024 · Aug 15, 2024 · Aug 15, 2024
diff --git a/docs/docs/en/flashcards/cards-with-blank-lines.md b/docs/docs/en/flashcards/cards-with-blank-lines.md
@@ -0,0 +1,60 @@
+# Including Blank Lines in Flashcards
+
+By default, [Multi-line Basic](qanda-cards.md#multi-line-basic), [Multi-line Bidirectional](qanda-cards.md#multi-line-bidirectional) 
+and [Cloze](basic-cloze-cards.md) type flashcards recognize a blank line as the end of the flashcard text.
+This means that blank lines can not be included within the text.
+
+If blank lines need to be included (e.g. on a card containing a markdown table), the
+`Characters denoting the end of clozes and multiline flashcards` [setting](../user-options.md#flashcard-separators)
+needs to be changed.
+
+For example, it could be changed to `+++`.
+
+!!! warning "Global Edit Required"
+    Note that after changing this you have to manually edit any flashcards you already have.
+
+## Including a Table in the Flashcard Answer
+
+!!! note "Obsidian requires a blank line before a table for it to be displayed correctly."
+    Without it, Obsidian displays it just as text and not correctly formatted.
+
+    ![table-with-no-preceding-blank-line](https://github.com/user-attachments/assets/daed1309-3b38-4d14-bb42-b302efda96df)
+
+    And with a blank line after the `?` and before the table, it is displays correctly.
+    ![table-with-preceding-blank-line](https://github.com/user-attachments/assets/beef90b7-324e-4876-b10b-055a4d23d41f)
+
+However, by default a blank line signifies the end of the multiline card.
+
+To include the blank line, the
+`Characters denoting the end of clozes and multiline flashcards` [setting](../user-options.md#flashcard-separators)
+needs to be changed. Then that character sequence added as a line after the end of the flashcard text. For example:
+
+![table-with-preceding-blank-line+++](https://github.com/user-attachments/assets/954fd7fc-6d5f-4315-b40e-2192664c3962)
+
+Now the card is displayed correctly during a review.
+
+![table-with-preceding-blank-line-review](https://github.com/user-attachments/assets/3bff8d25-f91f-4bc0-b922-7471d6b60869)
+
+## Including Blank Lines in a Cloze Flashcard
+
+With `Convert ==highlights== to clozes` enabled in [settings](../user-options.md#flashcard-separators)
+and the `Characters denoting the end of clozes and multiline flashcards` set to `+++`,
+we can have blank lines in a cloze flashcard. E.g.
+
+![cloze-with-blank-lines](https://github.com/user-attachments/assets/f9d6f123-3378-41cb-9c93-2b061856c81d)
+
+As there are 3 clozes defined, three separate cards will be generated for review.
+One card, for example is:
+
+![cloze-with-blank-lines-front1](https://github.com/user-attachments/assets/6b939d46-b93a-4a67-96d4-6985ccafb76e)
+
+And after `Show Answer` is clicked, the following is displayed:
+
+![cloze-with-blank-lines-answer](https://github.com/user-attachments/assets/225abd90-20a4-4e29-abb3-36beb61388d7)
+
+## Limitation
+
+### Blank Lines in Answer Side Only
+
+Blank lines are only supported in the answer side of a multiline flashcard, and not in the question side.
+
diff --git a/docs/docs/en/flashcards/flashcards-overview.md b/docs/docs/en/flashcards/flashcards-overview.md
@@ -56,6 +56,13 @@ If there are multiple cards defined by a single flashcard, those cards are known
 A special scheduling option is available for the review of sibling cards. If the [Bury sibling cards until the next day]( ../user-options.md#flashcard-review) setting is turned on, 
 only one sibling card is available for review on a single day.
 
+### Including Blank Lines within Multiline and Cloze Flashcards
+
+By default, the end of a multiline flashcard is denoted by a blank line at the end of the flashcard text.
+This means that blank lines can not be included within the text.
+
+See [Cards with Blank Lines](cards-with-blank-lines.md) if blank lines need to be included.
+
 ---
 
 

diff --git a/docs/docs/en/flashcards/qanda-cards.md b/docs/docs/en/flashcards/qanda-cards.md
@@ -103,7 +103,9 @@ the answer
     </div>
 
 
-These can also span over multiple lines as long as both sides "touch" the `?`:
+These can also span over multiple lines as long as both sides "touch" the `?`.
+
+See [Cards with Blank Lines](cards-with-blank-lines.md) if blank lines need to be included.
 
 
 
@@ -128,6 +130,7 @@ info 2B
 ```
 
 These can also span over multiple lines as long as both sides "touch" the `??`:
+To include blank lines, see the section below.
 
 !!! note "Card 1"
     <div class="grid" markdown>
@@ -162,6 +165,3 @@ These can also span over multiple lines as long as both sides "touch" the `??`:
 
 These two cards are considered sibling cards. See [sibling cards](flashcards-overview.md#sibling-cards) regarding the 
 [Bury sibling cards until the next day]( ../user-options.md#flashcard-review) scheduling option.
-
-
-
diff --git a/docs/docs/en/user-options.md b/docs/docs/en/user-options.md
@@ -12,7 +12,7 @@
 
 ### Flashcard Separators
 
-![flashcard-settings-separators](https://github.com/user-attachments/assets/bc5706de-80d7-445d-9e9c-5c9fe6d9522a)
+![flashcard-settings-separators](https://github.com/user-attachments/assets/744aea85-fdb3-4508-b532-7a551253f97d)
 
 ### Storage of Scheduling Data
 

diff --git a/docs/media/en/cloze-with-blank-lines-answer.jpg b/docs/media/en/cloze-with-blank-lines-answer.jpg
diff --git a/docs/media/en/cloze-with-blank-lines-front1.jpg b/docs/media/en/cloze-with-blank-lines-front1.jpg
diff --git a/docs/media/en/cloze-with-blank-lines.jpg b/docs/media/en/cloze-with-blank-lines.jpg
diff --git a/docs/media/en/flashcard-settings-separators.jpg b/docs/media/en/flashcard-settings-separators.jpg
diff --git a/docs/media/en/image-annotation.docx b/docs/media/en/image-annotation.docx
diff --git a/docs/media/en/table-with-no-preceding-blank-line.jpg b/docs/media/en/table-with-no-preceding-blank-line.jpg
diff --git a/docs/media/en/table-with-preceding-blank-line+++.jpg b/docs/media/en/table-with-preceding-blank-line+++.jpg
diff --git a/docs/media/en/table-with-preceding-blank-line-review.jpg b/docs/media/en/table-with-preceding-blank-line-review.jpg
diff --git a/docs/media/en/table-with-preceding-blank-line.jpg b/docs/media/en/table-with-preceding-blank-line.jpg
diff --git a/docs/user-doco-vault/en/User Guide/Cloze with blank lines.md b/docs/user-doco-vault/en/User Guide/Cloze with blank lines.md
@@ -0,0 +1,9 @@
+#flashcards
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. ==Nam efficitur et nulla vel porttitor. Nam a neque in massa egestas rutrum.== Maecenas in nulla ipsum. Donec a lobortis justo. Donec tincidunt lorem dui. Praesent nulla nisi, facilisis vitae tincidunt nec, mollis id eros. 
+
+Duis eget volutpat magna. Nam sit amet est ac diam venenatis sollicitudin. Aliquam finibus ante quis bibendum dignissim. ==Maecenas quis semper risus==. Nam condimentum a tellus et vestibulum. Nullam porta arcu in orci efficitur, sed suscipit urna imperdiet. 
+
+Phasellus sodales dictum erat sit amet posuere. ==Vestibulum volutpat, turpis at bibendum mollis, turpis leo elementum lacus, ac finibus mi orci ac enim.== Quisque porta eleifend diam, sit amet sagittis odio pulvinar sed. Aenean tristique enim eu dui pulvinar, eget ornare ante scelerisque.
+
++++
diff --git a/docs/user-doco-vault/en/User Guide/Cloze with table using+++.md b/docs/user-doco-vault/en/User Guide/Cloze with table using+++.md
@@ -0,0 +1,13 @@
+
+#flashcards
+
+
+| Name                     | Description                                                                          |
+| ------------------------ | ------------------------------------------------------------------------------------ |
+| ==[[Amazon Inspector]]== | ==Automated and continual vulnerability management at scale (within EC2 instances)== |
+| [[AWS GuardDuty]]        | Protect your AWS accounts with intelligent threat detection                          |
+| [[AWS Security Hub]]     | ==Automate AWS security checks and centralize security alerts==                      |
+| [[AWS Shield]]           | Maximize application availability and responsiveness with managed DDoS protection    |
+<!--SR:!2024-08-28,4,270!2000-01-01,1,250!2024-08-25,1,232-->
++++
+
diff --git a/docs/user-doco-vault/en/User Guide/Context.md b/docs/user-doco-vault/en/User Guide/Context.md
@@ -8,6 +8,7 @@
 ### Africa
 
 Kenya::Nairobi
+<!--SR:!2024-08-25,1,230-->
 
 ### North America
 

diff --git a/docs/user-doco-vault/en/User Guide/Multiline with blank lines in answer.md b/docs/user-doco-vault/en/User Guide/Multiline with blank lines in answer.md
@@ -0,0 +1,28 @@
+#flashcards 
+
+# Table with no preceding blank line
+
+List 4 AWS security related services
+?
+| Name                 | Description                                                                       |
+| -------------------- | --------------------------------------------------------------------------------- |
+| [[Amazon Inspector]] | Automated and continual vulnerability management at scale (within EC2 instances)  |
+| [[AWS GuardDuty]]    | Protect your AWS accounts with intelligent threat detection                       |
+| [[AWS Security Hub]] | Automate AWS security checks and centralize security alerts                       |
+| [[AWS Shield]]       | Maximize application availability and responsiveness with managed DDoS protection |
+
+# Table with preceding blank line
+
+List 4 AWS security related services
+?
+
+| Name                 | Description                                                                       |
+| -------------------- | --------------------------------------------------------------------------------- |
+| [[Amazon Inspector]] | Automated and continual vulnerability management at scale (within EC2 instances)  |
+| [[AWS GuardDuty]]    | Protect your AWS accounts with intelligent threat detection                       |
+| [[AWS Security Hub]] | Automate AWS security checks and centralize security alerts                       |
+| [[AWS Shield]]       | Maximize application availability and responsiveness with managed DDoS protection |
+
+
+
+
diff --git a/docs/user-doco-vault/en/User Guide/Table with preceding blank line and+++.md b/docs/user-doco-vault/en/User Guide/Table with preceding blank line and+++.md
@@ -0,0 +1,14 @@
+#flashcards
+
+List 4 AWS security related services
+?
+
+| Name                 | Description                                                                       |
+| -------------------- | --------------------------------------------------------------------------------- |
+| [[Amazon Inspector]] | Automated and continual vulnerability management at scale (within EC2 instances)  |
+| [[AWS GuardDuty]]    | Protect your AWS accounts with intelligent threat detection                       |
+| [[AWS Security Hub]] | Automate AWS security checks and centralize security alerts                       |
+| [[AWS Shield]]       | Maximize application availability and responsiveness with managed DDoS protection |
+<!--SR:!2024-08-26,1,230-->
++++
+
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -36,6 +36,7 @@ nav:
           - Flashcards Overview: flashcards/flashcards-overview.md
           - Question & Answer Cards: flashcards/qanda-cards.md
           - Cloze Cards: flashcards/basic-cloze-cards.md
+          - Cards with Blank Lines: flashcards/cards-with-blank-lines.md
           - Organizing into Decks: flashcards/decks.md
           - Reviewing & Cramming: flashcards/reviewing.md
           - Statistics: flashcards/statistics.md

diff --git a/package.json b/package.json
@@ -48,7 +48,8 @@
     },
     "dependencies": {
         "chart.js": "^4.4.2",
-        "pagerank.js": "^1.0.2"
+        "pagerank.js": "^1.0.2",
+        "peggy": "^4.0.3"
     },
     "packageManager": "^pnpm@8.15.4"
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/NoteQuestionParser.ts b/src/NoteQuestionParser.ts
@@ -1,7 +1,7 @@
 import { TagCache } from "obsidian";
 import { Card } from "./Card";
 import { CardScheduleInfo, NoteCardScheduleParser } from "./CardSchedule";
-import { parseEx, ParsedQuestionInfo } from "./parser";
+import { parseEx, ParsedQuestionInfo, ParserOptions } from "./parser";
 import { Question, QuestionText } from "./Question";
 import { CardFrontBack, CardFrontBackUtil } from "./QuestionType";
 import { SRSettings, SettingsUtil } from "./settings";
@@ -136,17 +136,18 @@ export class NoteQuestionParser {
 
     private parseQuestions(): ParsedQuestionInfo[] {
         // We pass contentText which has the frontmatter blanked out; see extractFrontmatter for reasoning
-        const settings: SRSettings = this.settings;
-        const result: ParsedQuestionInfo[] = parseEx(
-            this.contentText,
-            settings.singleLineCardSeparator,
-            settings.singleLineReversedCardSeparator,
-            settings.multilineCardSeparator,
-            settings.multilineReversedCardSeparator,
-            settings.convertHighlightsToClozes,
-            settings.convertBoldTextToClozes,
-            settings.convertCurlyBracketsToClozes,
-        );
+        const parserOptions: ParserOptions = {
+            singleLineCardSeparator:this.settings.singleLineCardSeparator,
+            singleLineReversedCardSeparator: this.settings.singleLineReversedCardSeparator,
+            multilineCardSeparator: this.settings.multilineCardSeparator,
+            multilineReversedCardSeparator: this.settings.multilineReversedCardSeparator,
+            multilineCardEndMarker: this.settings.multilineCardEndMarker,
+            convertHighlightsToClozes: this.settings.convertHighlightsToClozes,
+            convertBoldTextToClozes: this.settings.convertBoldTextToClozes,
+            convertCurlyBracketsToClozes: this.settings.convertCurlyBracketsToClozes,
+        };
+
+        const result: ParsedQuestionInfo[] = parseEx(this.contentText, parserOptions);
         return result;
     }