Python-Markdown's Markdown-in-HTML extension is now enabled (#13)

gpoore · Jun 16, 2020 · fc362f7 · fc362f7
1 parent 136e930
commit fc362f7
Show file tree

Hide file tree

Showing 4 changed files with 39 additions and 2 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -8,6 +8,7 @@
   for newlines in HTML comments.  The preprocessor now skips backslash
   escapes, inline code containing newlines, and fenced code blocks (as long as
   they do not start on the same line as a list marker).
+* Python-Markdown's Markdown-in-HTML extension is now enabled (#13).
 
 
 

diff --git a/README.md b/README.md
@@ -356,6 +356,34 @@ text, which typically appears as italics.  Text can be styled using Markdown
 notation, or with HTML.  Remember to preview quizzes after conversion to QTI,
 especially when using any significant amount of HTML.
 
+Python-Markdown provides several
+[extensions to basic Markdown](https://python-markdown.github.io/extensions/).
+Currently, the following extensions are enabled:
+* `smarty`:  Automatic curly quotation marks and dashes.
+* `sane_lists`:  List behavior is closer to what might be expected.
+* `def_list`:  Definition lists of this form:
+  ```
+  term
+  :   definition
+* `fenced_code`:  Fenced code blocks (` ``` ` or `~~~`).
+* `footnotes`:  Footnotes using this form:
+  ```
+  Normal text [^1].
+
+  [^1]: Footnote text.
+* `tables`:  Tables of this form:
+  ```
+  Header | Header
+  ------ | ------
+  Cell   | Cell
+  Cell   | Cell
+  ```
+* `md_in_html`:  Text inside HTML tags is treated as Markdown.  This requires
+  setting the attribute `markdown="1"` in the opening tag for block-level
+  elements.  See the
+  [documentation](https://python-markdown.github.io/extensions/md_in_html/)
+  for more details about proper usage and potential issues.
+
 While indented Markdown code blocks are supported, fenced code blocks should
 be preferred.  Indented code can interfere with the preprocessor that strips
 HTML comments and handles LaTeX math and siunitx notation.

diff --git a/text2qti/markdown.py b/text2qti/markdown.py
@@ -108,7 +108,15 @@ class Markdown(object):
     def __init__(self, config: Config):
         self.config = config
 
-        md_extensions = ['smarty', 'sane_lists', 'def_list', 'fenced_code', 'footnotes', 'tables']
+        md_extensions = [
+            'smarty',
+            'sane_lists',
+            'def_list',
+            'fenced_code',
+            'footnotes',
+            'tables',
+            'md_in_html',
+        ]
         markdown_processor = markdown.Markdown(extensions=md_extensions)
         markdown_image_processor = Text2qtiImagePattern(IMAGE_LINK_RE, markdown_processor, self)
         markdown_processor.inlinePatterns.register(markdown_image_processor, 'image_link', 150)

diff --git a/text2qti/version.py b/text2qti/version.py
@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 
 from .fmtversion import get_version_plus_info
-__version__, __version_info__ = get_version_plus_info(0, 4, 0, 'dev', 2)
+__version__, __version_info__ = get_version_plus_info(0, 4, 0, 'dev', 3)