flowmark 0.4.1__tar.gz → 0.4.2__tar.gz

{flowmark-0.4.1 → flowmark-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowmark
-Version: 0.4.1
+Version: 0.4.2
 Summary: Better line wrapping and formatting for plaintext and Markdown
 Project-URL: Repository, https://github.com/jlevy/flowmark
 Author-email: Joshua Levy <joshua@cal.berkeley.edu>
@@ -153,8 +153,7 @@ experience.
 Flowmark can be used as a library or as a CLI.
 
 ```
-$ flowmark --help
-usage: flowmark [-h] [-o OUTPUT] [-w WIDTH] [-p] [-s] [-i] [--nobackup] [file]
+usage: flowmark [-h] [-o OUTPUT] [-w WIDTH] [-p] [-s] [-i] [--nobackup] [--auto] [--version] [file]
 
 Flowmark: Better line wrapping and formatting for plaintext and Markdown
 
@@ -166,9 +165,11 @@ options:
   -o, --output OUTPUT  Output file (use '-' for stdout)
   -w, --width WIDTH    Line width to wrap to
   -p, --plaintext      Process as plaintext (no Markdown parsing)
-  -s, --semantic       Enable sentence-based line breaks (only applies to Markdown mode)
+  -s, --semantic       Enable semantic (sentence-based) line breaks (only applies to Markdown mode)
   -i, --inplace        Edit the file in place (ignores --output)
   --nobackup           Do not make a backup of the original file when using --inplace
+  --auto               Same as `--inplace --nobackup --semantic`, as a convenience for auto-formatting files
+  --version            Show version information and exit
 
 Flowmark provides enhanced text wrapping capabilities with special handling for
 Markdown content. It can:
@@ -197,12 +198,26 @@ Command-line usage examples:
   # Process plaintext instead of Markdown
   flowmark --plaintext text.txt
 
-  # Use sentences to guide line breaks (good for many purposes git history and diffs)
+  # Use semantic line breaks (based on sentences, which is helpful to reduce
+  # irrelevant line wrap diffs in git history)
   flowmark --semantic README.md
 
 For more details, see: https://github.com/jlevy/flowmark
 ```
 
+## Other Notes
+
+- This enables
+  [GitHub-flavored Markdown support](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
+  using
+  [Marko's extension](https://github.com/frostming/marko/blob/master/marko/ext/footnote.py).
+
+- GFM-style tables are supported and also auto-formatted.
+
+- GFM-style footnotes are supported.
+  But note these aren't actually in the GFM spec, but we follow
+  [micromark's conventions](https://github.com/frostming/marko/blob/master/marko/ext/footnote.py).
+
 ## Project Docs
 
 For how to install uv and Python, see [installation.md](installation.md).

{flowmark-0.4.1 → flowmark-0.4.2}/README.md

@@ -129,8 +129,7 @@ experience.
 Flowmark can be used as a library or as a CLI.
 
 ```
-$ flowmark --help
-usage: flowmark [-h] [-o OUTPUT] [-w WIDTH] [-p] [-s] [-i] [--nobackup] [file]
+usage: flowmark [-h] [-o OUTPUT] [-w WIDTH] [-p] [-s] [-i] [--nobackup] [--auto] [--version] [file]
 
 Flowmark: Better line wrapping and formatting for plaintext and Markdown
 
@@ -142,9 +141,11 @@ options:
   -o, --output OUTPUT  Output file (use '-' for stdout)
   -w, --width WIDTH    Line width to wrap to
   -p, --plaintext      Process as plaintext (no Markdown parsing)
-  -s, --semantic       Enable sentence-based line breaks (only applies to Markdown mode)
+  -s, --semantic       Enable semantic (sentence-based) line breaks (only applies to Markdown mode)
   -i, --inplace        Edit the file in place (ignores --output)
   --nobackup           Do not make a backup of the original file when using --inplace
+  --auto               Same as `--inplace --nobackup --semantic`, as a convenience for auto-formatting files
+  --version            Show version information and exit
 
 Flowmark provides enhanced text wrapping capabilities with special handling for
 Markdown content. It can:
@@ -173,12 +174,26 @@ Command-line usage examples:
   # Process plaintext instead of Markdown
   flowmark --plaintext text.txt
 
-  # Use sentences to guide line breaks (good for many purposes git history and diffs)
+  # Use semantic line breaks (based on sentences, which is helpful to reduce
+  # irrelevant line wrap diffs in git history)
   flowmark --semantic README.md
 
 For more details, see: https://github.com/jlevy/flowmark
 ```
 
+## Other Notes
+
+- This enables
+  [GitHub-flavored Markdown support](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
+  using
+  [Marko's extension](https://github.com/frostming/marko/blob/master/marko/ext/footnote.py).
+
+- GFM-style tables are supported and also auto-formatted.
+
+- GFM-style footnotes are supported.
+  But note these aren't actually in the GFM spec, but we follow
+  [micromark's conventions](https://github.com/frostming/marko/blob/master/marko/ext/footnote.py).
+
 ## Project Docs
 
 For how to install uv and Python, see [installation.md](installation.md).

{flowmark-0.4.1 → flowmark-0.4.2}/src/flowmark/custom_marko.py

@@ -7,6 +7,7 @@ from typing import Any, cast
 
 from marko import Markdown, Renderer, block, inline
 from marko.block import HTMLBlock
+from marko.ext import footnote
 from marko.ext.gfm import GFM
 from marko.ext.gfm import elements as gfm_elements
 from marko.parser import Parser
@@ -187,10 +188,18 @@ class MarkdownNormalizer(Renderer):
         return result
 
     def render_link_ref_def(self, element: block.LinkRefDef) -> str:
+        """Render a standard link reference definition:
+        [label]: url "title"
+        """
         link_text = element.dest
         if element.title:
-            link_text += f" {element.title}"
-        return f"[{element.label}]: {link_text}\n"
+            # Ensure title quotes are handled correctly
+            escaped_title = element.title.replace('"', '\\"')
+            link_text += f' "{escaped_title}"'
+        result = f"{self._prefix}[{element.label}]: {link_text}\n"
+        self._prefix = self._second_prefix
+        self._suppress_item_break = True
+        return result
 
     def render_emphasis(self, element: inline.Emphasis) -> str:
         return f"*{self.render_children(element)}*"
@@ -243,6 +252,29 @@ class MarkdownNormalizer(Renderer):
 
     # --- GFM Renderer Methods ---
 
+    def render_footnote_ref(self, element: footnote.FootnoteRef) -> str:
+        """Render an inline footnote reference like [^label]."""
+        return f"[^{element.label}]"
+
+    def render_footnote_def(self, element: footnote.FootnoteDef) -> str:
+        """
+        Render a GFM footnote definition, handling content wrapping.
+        Note multiline footnotes aren't very well specified but we use
+        standard 4-space indentation. See:
+        https://github.com/micromark/micromark-extension-gfm-footnote
+        """
+        # Render label and the rest within an indented container.
+        label_part = f"[^{element.label}]: "
+        with self.container(label_part, "    "):
+            content = self.render_children(element)
+
+        # Set up state for the *next* block element using the restored outer secondary prefix.
+        self._prefix = self._second_prefix
+        self._suppress_item_break = True  # This definition acts as a block separator.
+
+        # Footnote defs should be separated by extra newlines.
+        return content.rstrip("\n") + "\n\n"
+
     def render_strikethrough(self, element: gfm_elements.Strikethrough) -> str:
         return f"~~{self.render_children(element)}~~"
 
@@ -288,12 +320,19 @@ def custom_marko(line_wrapper: LineWrapper) -> Markdown:
             # Using Marko's full extension system is tricky with our customizations so simpler
             # to do this manually.
             custom_parser = CustomParser()
+            # Add GFM support.
             for e in GFM.elements:
                 assert (
                     e not in custom_parser.block_elements and e not in custom_parser.inline_elements
                 )
                 custom_parser.add_element(e)
-
+            # Add GFM footnote support.
+            footnote_ext = footnote.make_extension()
+            for e in footnote_ext.elements:
+                assert (
+                    e not in custom_parser.block_elements and e not in custom_parser.inline_elements
+                )
+                custom_parser.add_element(e)
             self.parser: Parser = custom_parser
             self.renderer: Renderer = CustomRenderer()
 

{flowmark-0.4.1 → flowmark-0.4.2}/src/flowmark/line_wrappers.py

@@ -30,6 +30,7 @@ def split_sentences_no_min_length(text: str) -> list[str]:
 def line_wrap_to_width(
     width: int = DEFAULT_WRAP_WIDTH,
     len_fn: Callable[[str], int] = DEFAULT_LEN_FUNCTION,
+    is_markdown: bool = False,
 ) -> LineWrapper:
     """
     Wrap lines of text to a given width.
@@ -42,6 +43,7 @@ def line_wrap_to_width(
             initial_indent=initial_indent,
             subsequent_indent=subsequent_indent,
             len_fn=len_fn,
+            is_markdown=is_markdown,
         )
 
     return line_wrapper
@@ -52,6 +54,7 @@ def line_wrap_by_sentence(
     width: int = DEFAULT_WRAP_WIDTH,
     min_line_len: int = DEFAULT_MIN_LINE_LEN,
     len_fn: Callable[[str], int] = DEFAULT_LEN_FUNCTION,
+    is_markdown: bool = False,
 ) -> LineWrapper:
     """
     Wrap lines of text to a given width but also keep sentences on their own lines.
@@ -79,6 +82,7 @@ def line_wrap_by_sentence(
                 width=width,
                 initial_column=current_column,
                 subsequent_offset=subsequent_indent_len,
+                is_markdown=is_markdown,
             )
             # If last line is shorter than min_line_len, combine with next line.
             # Also handles if the first word doesn't fit.

{flowmark-0.4.1 → flowmark-0.4.2}/src/flowmark/markdown_filling.py

@@ -99,9 +99,10 @@ def fill_markdown(
     beginning of the document.
     """
     if line_wrapper is None:
-        line_wrapper = (
-            line_wrap_by_sentence(width=width) if semantic else line_wrap_to_width(width=width)
-        )
+        if semantic:
+            line_wrapper = line_wrap_by_sentence(width=width, is_markdown=True)
+        else:
+            line_wrapper = line_wrap_to_width(width=width, is_markdown=True)
 
     # Extract frontmatter before any processing
     frontmatter, content = split_frontmatter(markdown_text)

{flowmark-0.4.1 → flowmark-0.4.2}/src/flowmark/text_wrapping.py

@@ -71,6 +71,29 @@ Split words, but not within HTML tags or Markdown links.
 """
 
 
+# Pattern to identify words that need escaping if they start a wrapped markdown line.
+# Matches list markers (*, +, -) bare or before a space (but not before a letter for
+# example), blockquotes (> ), headings (#, ##, etc.).
+_md_specials_pat = re.compile(r"^[-*+](?: |$)|> |#+$")
+
+# Separate pattern to specifically find the numbered list cases for targeted escaping
+_md_numeral_pat = re.compile(r"^[0-9]+[.)]$")
+
+
+def markdown_escape_word(word: str) -> str:
+    """
+    Prepends a backslash to a word if it matches markdown patterns
+    that need escaping at the start of a wrapped line.
+    For numbered lists (e.g., "1.", "1)"), inserts the backslash before the dot/paren.
+    """
+    if _md_numeral_pat.match(word):
+        # Insert backslash before the `.` or `)`
+        return word[:-1] + "\\" + word[-1]
+    elif _md_specials_pat.match(word):
+        return "\\" + word
+    return word
+
+
 def wrap_paragraph_lines(
     text: str,
     width: int,
@@ -80,10 +103,13 @@ def wrap_paragraph_lines(
     drop_whitespace: bool = True,
     splitter: WordSplitter = html_md_word_splitter,
     len_fn: Callable[[str], int] = DEFAULT_LEN_FUNCTION,
+    is_markdown: bool = False,
 ) -> list[str]:
     """
     Wrap a single paragraph of text, returning a list of wrapped lines.
     Rewritten to simplify and generalize Python's textwrap.py.
+    Set `is_markdown` to True when wrapping markdown text to automatically
+    escape special markdown characters at the start of wrapped lines.
     """
     if replace_whitespace:
         text = re.sub(r"\s+", " ", text)
@@ -93,6 +119,7 @@ def wrap_paragraph_lines(
     lines: list[str] = []
     current_line: list[str] = []
     current_width = initial_column
+    first_line = True
 
     # Walk through words, breaking them into lines.
     for word in words:
@@ -110,9 +137,21 @@ def wrap_paragraph_lines(
                 if drop_whitespace:
                     line = line.strip()
                 lines.append(line)
-            current_line = [word]
-            current_width = subsequent_offset + word_width
+                first_line = False
+
+            # Check if word needs escaping at the start of this wrapped line.
+            escaped_word = word
+            if is_markdown and not first_line:
+                escaped_word = markdown_escape_word(word)
+
+            # Recalculate width after potential escaping for the new line.
+            escaped_word_width = len_fn(escaped_word)
+
+            # Start the new line with the (potentially escaped) word
+            current_line = [escaped_word]
+            current_width = subsequent_offset + escaped_word_width
 
+    # Add the last line if necessary.
     if current_line:
         line = " ".join(current_line)
         if drop_whitespace:
@@ -132,6 +171,7 @@ def wrap_paragraph(
     drop_whitespace: bool = True,
     word_splitter: WordSplitter = html_md_word_splitter,
     len_fn: Callable[[str], int] = DEFAULT_LEN_FUNCTION,
+    is_markdown: bool = False,
 ) -> str:
     """
     Wrap lines of a single paragraph of plain text, returning a new string.
@@ -146,6 +186,7 @@ def wrap_paragraph(
         initial_column=initial_column + len_fn(initial_indent),
         subsequent_offset=len_fn(subsequent_indent),
         len_fn=len_fn,
+        is_markdown=is_markdown,
     )
     # Now insert indents on first and subsequent lines, if needed.
     if initial_indent and initial_column == 0 and len(lines) > 0:

{flowmark-0.4.1 → flowmark-0.4.2}/tests/test_wrapping.py

@@ -3,12 +3,105 @@ from textwrap import dedent
 from flowmark.text_wrapping import (
     _HtmlMdWordSplitter,  # pyright: ignore
     html_md_word_splitter,
+    markdown_escape_word,
     simple_word_splitter,
     wrap_paragraph,
     wrap_paragraph_lines,
 )
 
 
+def test_markdown_escape_word_function() -> None:
+    # Cases that should be escaped
+    assert markdown_escape_word("-") == "\\-"
+    assert markdown_escape_word("+") == "\\+"
+    assert markdown_escape_word("*") == "\\*"
+    assert markdown_escape_word(">") == ">"
+    assert markdown_escape_word("#") == "\\#"
+    assert markdown_escape_word("##") == "\\##"
+    assert markdown_escape_word("1.") == "1\\."
+    assert markdown_escape_word("10.") == "10\\."
+    assert markdown_escape_word("1)") == "1\\)"
+    assert markdown_escape_word("99)") == "99\\)"
+
+    # Cases that should NOT be escaped
+    assert markdown_escape_word("word") == "word"
+    assert markdown_escape_word("-word") == "-word"  # Starts with char, but not just char
+    assert markdown_escape_word("word-") == "word-"  # Ends with char
+    assert markdown_escape_word("#word") == "#word"
+    assert markdown_escape_word("word#") == "word#"
+    assert markdown_escape_word("1.word") == "1.word"
+    assert markdown_escape_word("word1.") == "word1."
+    assert markdown_escape_word("1)word") == "1)word"
+    assert markdown_escape_word("word1)") == "word1)"
+    assert markdown_escape_word("<tag>") == "<tag>"  # Other symbols
+    assert markdown_escape_word("[link]") == "[link]"
+    assert markdown_escape_word("1") == "1"  # Just number
+    assert markdown_escape_word(".") == "."  # Just dot
+
+
+def test_wrap_paragraph_lines_markdown_escaping():
+    assert wrap_paragraph_lines(text="- word", width=10, is_markdown=True) == ["- word"]
+
+    text = "word - word * word + word > word # word ## word 1. word 2) word"
+
+    assert wrap_paragraph_lines(text=text, width=5, is_markdown=True) == [
+        "word",
+        "\\-",
+        "word",
+        "\\*",
+        "word",
+        "\\+",
+        "word",
+        ">",
+        "word",
+        "\\#",
+        "word",
+        "\\##",
+        "word",
+        "1\\.",
+        "word",
+        "2\\)",
+        "word",
+    ]
+    assert wrap_paragraph_lines(text=text, width=10, is_markdown=True) == [
+        "word -",
+        "word *",
+        "word +",
+        "word >",
+        "word #",
+        "word ##",
+        "word 1.",
+        "word 2)",
+        "word",
+    ]
+    assert wrap_paragraph_lines(text=text, width=15, is_markdown=True) == [
+        "word - word *",
+        "word + word >",
+        "word # word ##",
+        "word 1. word 2)",
+        "word",
+    ]
+    assert wrap_paragraph_lines(text=text, width=20, is_markdown=True) == [
+        "word - word * word +",
+        "word > word # word",
+        "\\## word 1. word 2)",
+        "word",
+    ]
+    assert wrap_paragraph_lines(text=text, width=20, is_markdown=False) == [
+        "word - word * word +",
+        "word > word # word",
+        "## word 1. word 2)",
+        "word",
+    ]
+
+    test2 = """Testing - : Is Ketamine Contraindicated in Patients with Psychiatric Disorders? - REBEL EM - more words - accessed April 24, 2025, <https://rebelem.com/is-ketamine-contraindicated-in-patients-with-psychiatric-disorders/>"""
+    assert wrap_paragraph_lines(text=test2, width=80, is_markdown=True) == [
+        "Testing - : Is Ketamine Contraindicated in Patients with Psychiatric Disorders?",
+        "\\- REBEL EM - more words - accessed April 24, 2025,",
+        "<https://rebelem.com/is-ketamine-contraindicated-in-patients-with-psychiatric-disorders/>",
+    ]
+
+
 def test_smart_splitter():
     splitter = _HtmlMdWordSplitter()
 

{flowmark-0.4.1 → flowmark-0.4.2}/tests/testdocs/testdoc.orig.md

@@ -569,6 +569,9 @@ Links like these underline ones come up from some exports. And let's try some li
 
 [^53]: <https://www.fastcompany.com/90216464/the-29-billion-battle-to-own-how-america-sleeps>
 
+[^217]: Testing - : Is Ketamine Contraindicated in Patients with Psychiatric Disorders? - REBEL EM - more words - accessed April 24, 2025,
+  <https://rebelem.com/is-ketamine-contraindicated-in-patients-with-psychiatric-disorders/>
+
 [^multiline]: The distinction between “hiring” and “recruiting” isn’t
     universally agreed upon. Some people think of hiring as a superset
     of recruiting, some consider it to be the other way around. However

{flowmark-0.4.1 → flowmark-0.4.2}/tests/testdocs/testdoc.out.cleaned.md

@@ -239,7 +239,7 @@ to $24,000, which means the tax benefit of buying is
 * When an investor is trying to get you to agree to a term you think is unfair, you need
   to protect your interests without sounding accusatory toward the investor: *“Sorry,
   I’m just inexperienced, I read/was told that it’s not wise to [term they want you to
-  agree to].”* [[Paul Graham, Y Combinator][^191]]
+  agree to].”* [[Paul Graham, Y Combinator](http://paulgraham.com/fr.html)]
 
 * When you want to test a VC’s interest to determine where to put your energy, you don’t
   want to sound desperate or pushy: *“I know that you’re not likely to give me a strong
@@ -867,14 +867,13 @@ not complaining)[^urbanthowt.wy49lp].
 ❗️️️ Having multiple automatic conversion thresholds can give the investor with a higher
 threshold leverage to block an IPO.[^210]
 
-[^2]: Aulet, Bill. *Disciplined Entrepreneurship*: 24 Steps to a Successful Startup
-(Kindle Location 1220). Wiley, 2013. Kindle Edition.
+[^2]: Aulet, Bill. *Disciplined Entrepreneurship*: 24 Steps to a Successful Startup (Kindle
+    Location 1220). Wiley, 2013. Kindle Edition.
 
 [^191]: http://paulgraham.com/fr.html
 
-[^177]: Carnegie, Dale.
-*How To Win Friends and Influence People* (p. 35). Simon & Schuster.
-Kindle Edition.
+[^177]: Carnegie, Dale. *How To Win Friends and Influence People* (p. 35). Simon & Schuster.
+    Kindle Edition.
 
 [^207]: [https://bostonvcblog.typepad.com/vc/2009/07/in-vc-deals-price-doesnt-matter-but-the-promote-does.html](https://bostonvcblog.typepad.com/vc/2009/07/in-vc-deals-price-doesnt-matter-but-the-promote-does.html)
 
@@ -889,29 +888,29 @@ And let's try some links with angle brackets.
 
 [^axioscomth.1lioru]: <https://www.axios.com/the-rise-of-pre-seed-venture-capital-1513305959-13da61c8-15f8-441e-b016-d29902bff8bf.html>
 
-[^carnegieda.327r3k]: Carnegie, Dale.
-*How To Win Friends and Influence People* (p. 35). Simon & Schuster.
-Kindle Edition.
+[^carnegieda.327r3k]: Carnegie, Dale. *How To Win Friends and Influence People* (p. 35). Simon & Schuster.
+    Kindle Edition.
 
 [^53]: <https://www.fastcompany.com/90216464/the-29-billion-battle-to-own-how-america-sleeps>
 
+[^217]: Testing - : Is Ketamine Contraindicated in Patients with Psychiatric Disorders?
+    - REBEL EM - more words - accessed April 24, 2025,
+    <https://rebelem.com/is-ketamine-contraindicated-in-patients-with-psychiatric-disorders/>
+
 [^multiline]: The distinction between “hiring” and “recruiting” isn’t universally agreed
-upon.
-Some people think of hiring as a superset of recruiting, some consider it to be the
-other way around. However you think of it, both recruiting and hiring involve selling
-candidates on the value proposition of a company and ensuring the alignment of interests
-between the two parties.
+    upon. Some people think of hiring as a superset of recruiting, some consider it to be
+    the other way around.
+    However you think of it, both recruiting and hiring involve selling candidates on
+    the value proposition of a company and ensuring the alignment of interests between
+    the two parties.
 
 [^multiparagraph]: This is an even longer footnote...
 
-```
-Paragraph 1.
+    Paragraph 1.
 
-> And even a
-> block quote.
+    > And even a block quote.
 
-Paragraph 3.
-```
+    Paragraph 3.
 
 And by contrast here a bare link is like this https://www.google.com/
 

{flowmark-0.4.1 → flowmark-0.4.2}/tests/testdocs/testdoc.out.plain.md

@@ -225,7 +225,7 @@ to $24,000, which means the tax benefit of buying is
 * When an investor is trying to get you to agree to a term you think is unfair, you need
   to protect your interests without sounding accusatory toward the investor: *“Sorry,
   I’m just inexperienced, I read/was told that it’s not wise to [term they want you to
-  agree to].”* [[Paul Graham, Y Combinator][^191]]
+  agree to].”* [[Paul Graham, Y Combinator](http://paulgraham.com/fr.html)]
 
 * When you want to test a VC’s interest to determine where to put your energy, you don’t
   want to sound desperate or pushy: *“I know that you’re not likely to give me a strong
@@ -830,12 +830,12 @@ not complaining)[^urbanthowt.wy49lp].
 threshold leverage to block an IPO.[^210]
 
 [^2]: Aulet, Bill. *Disciplined Entrepreneurship*: 24 Steps to a Successful Startup
-(Kindle Location 1220). Wiley, 2013. Kindle Edition.
+    (Kindle Location 1220). Wiley, 2013. Kindle Edition.
 
 [^191]: http://paulgraham.com/fr.html
 
 [^177]: Carnegie, Dale. *How To Win Friends and Influence People* (p. 35). Simon &
-Schuster. Kindle Edition.
+    Schuster. Kindle Edition.
 
 [^207]: [https://bostonvcblog.typepad.com/vc/2009/07/in-vc-deals-price-doesnt-matter-but-the-promote-does.html](https://bostonvcblog.typepad.com/vc/2009/07/in-vc-deals-price-doesnt-matter-but-the-promote-does.html)
 
@@ -851,26 +851,27 @@ angle brackets.
 [^axioscomth.1lioru]: <https://www.axios.com/the-rise-of-pre-seed-venture-capital-1513305959-13da61c8-15f8-441e-b016-d29902bff8bf.html>
 
 [^carnegieda.327r3k]: Carnegie, Dale. *How To Win Friends and Influence People* (p. 35).
-Simon & Schuster. Kindle Edition.
+    Simon & Schuster. Kindle Edition.
 
 [^53]: <https://www.fastcompany.com/90216464/the-29-billion-battle-to-own-how-america-sleeps>
 
+[^217]: Testing - : Is Ketamine Contraindicated in Patients with Psychiatric Disorders?
+    \- REBEL EM - more words - accessed April 24, 2025,
+    <https://rebelem.com/is-ketamine-contraindicated-in-patients-with-psychiatric-disorders/>
+
 [^multiline]: The distinction between “hiring” and “recruiting” isn’t universally agreed
-upon. Some people think of hiring as a superset of recruiting, some consider it to be
-the other way around. However you think of it, both recruiting and hiring involve
-selling candidates on the value proposition of a company and ensuring the alignment of
-interests between the two parties.
+    upon. Some people think of hiring as a superset of recruiting, some consider it to
+    be the other way around. However you think of it, both recruiting and hiring involve
+    selling candidates on the value proposition of a company and ensuring the alignment
+    of interests between the two parties.
 
 [^multiparagraph]: This is an even longer footnote...
 
-```
-Paragraph 1.
+    Paragraph 1.
 
-> And even a
-> block quote.
+    > And even a block quote.
 
-Paragraph 3.
-```
+    Paragraph 3.
 
 And by contrast here a bare link is like this https://www.google.com/
 

{flowmark-0.4.1 → flowmark-0.4.2}/tests/testdocs/testdoc.out.semantic.md

@@ -239,7 +239,7 @@ to $24,000, which means the tax benefit of buying is
 * When an investor is trying to get you to agree to a term you think is unfair, you need
   to protect your interests without sounding accusatory toward the investor: *“Sorry,
   I’m just inexperienced, I read/was told that it’s not wise to [term they want you to
-  agree to].”* [[Paul Graham, Y Combinator][^191]]
+  agree to].”* [[Paul Graham, Y Combinator](http://paulgraham.com/fr.html)]
 
 * When you want to test a VC’s interest to determine where to put your energy, you don’t
   want to sound desperate or pushy: *“I know that you’re not likely to give me a strong
@@ -867,14 +867,13 @@ not complaining)[^urbanthowt.wy49lp].
 ❗️️️ Having multiple automatic conversion thresholds can give the investor with a higher
 threshold leverage to block an IPO.[^210]
 
-[^2]: Aulet, Bill. *Disciplined Entrepreneurship*: 24 Steps to a Successful Startup
-(Kindle Location 1220). Wiley, 2013. Kindle Edition.
+[^2]: Aulet, Bill. *Disciplined Entrepreneurship*: 24 Steps to a Successful Startup (Kindle
+    Location 1220). Wiley, 2013. Kindle Edition.
 
 [^191]: http://paulgraham.com/fr.html
 
-[^177]: Carnegie, Dale.
-*How To Win Friends and Influence People* (p. 35). Simon & Schuster.
-Kindle Edition.
+[^177]: Carnegie, Dale. *How To Win Friends and Influence People* (p. 35). Simon & Schuster.
+    Kindle Edition.
 
 [^207]: [https://bostonvcblog.typepad.com/vc/2009/07/in-vc-deals-price-doesnt-matter-but-the-promote-does.html](https://bostonvcblog.typepad.com/vc/2009/07/in-vc-deals-price-doesnt-matter-but-the-promote-does.html)
 
@@ -889,29 +888,29 @@ And let's try some links with angle brackets.
 
 [^axioscomth.1lioru]: <https://www.axios.com/the-rise-of-pre-seed-venture-capital-1513305959-13da61c8-15f8-441e-b016-d29902bff8bf.html>
 
-[^carnegieda.327r3k]: Carnegie, Dale.
-*How To Win Friends and Influence People* (p. 35). Simon & Schuster.
-Kindle Edition.
+[^carnegieda.327r3k]: Carnegie, Dale. *How To Win Friends and Influence People* (p. 35). Simon & Schuster.
+    Kindle Edition.
 
 [^53]: <https://www.fastcompany.com/90216464/the-29-billion-battle-to-own-how-america-sleeps>
 
+[^217]: Testing - : Is Ketamine Contraindicated in Patients with Psychiatric Disorders?
+    - REBEL EM - more words - accessed April 24, 2025,
+    <https://rebelem.com/is-ketamine-contraindicated-in-patients-with-psychiatric-disorders/>
+
 [^multiline]: The distinction between “hiring” and “recruiting” isn’t universally agreed
-upon.
-Some people think of hiring as a superset of recruiting, some consider it to be the
-other way around. However you think of it, both recruiting and hiring involve selling
-candidates on the value proposition of a company and ensuring the alignment of interests
-between the two parties.
+    upon. Some people think of hiring as a superset of recruiting, some consider it to be
+    the other way around.
+    However you think of it, both recruiting and hiring involve selling candidates on
+    the value proposition of a company and ensuring the alignment of interests between
+    the two parties.
 
 [^multiparagraph]: This is an even longer footnote...
 
-```
-Paragraph 1.
+    Paragraph 1.
 
-> And even a
-> block quote.
+    > And even a block quote.
 
-Paragraph 3.
-```
+    Paragraph 3.
 
 And by contrast here a bare link is like this https://www.google.com/