Merge branch 'master' into feat/pydantic

Author: svlandeg

docs/release-notes.md

@@ -2,6 +2,12 @@
 
 ## Latest Changes
 
+## 0.27.1 (2026-08-03)
+
+### Features
+
+* ✨ Make `epilog` formatting consistent with other parts of the help string. PR [#1405](https://github.com/fastapi/typer/pull/1405) by [@svlandeg](https://github.com/svlandeg).
+
 ### Docs
 
 * 📝 Add Library Skills documentation. PR [#1906](https://github.com/fastapi/typer/pull/1906) by [@tiangolo](https://github.com/tiangolo).

tests/test_rich_markup_mode.py

@@ -330,3 +330,50 @@ def test_markup_mode_default():
     # We're assuming the test suite is run with rich installed
     app = typer.Typer()
     assert app.rich_markup_mode == "rich"
+
+
+@pytest.mark.parametrize(
+    "mode",
+    ["markdown", "rich", None],
+)
+def test_markup_mode_epilog(mode):
+    app = typer.Typer(rich_markup_mode=mode)
+
+    help_string = "Here is a help string"
+
+    epilog_string = """
+    Just wrapping up:
+
+    This is the first conclusion
+    Here is conclusion two
+
+    That's all folks!
+    """
+
+    @app.command(help=help_string, epilog=epilog_string)
+    def main():
+        print("Hello World")
+
+    assert app.rich_markup_mode == mode
+
+    result = runner.invoke(app)
+    assert "Hello World" in result.stdout
+
+    result = runner.invoke(app, ["--help"])
+    result_lines = [line.strip() for line in result.stdout.split("\n")]
+    first_index = result_lines.index("Just wrapping up:")
+    assert first_index > 0
+    assert result_lines[first_index + 1] == ""
+
+    if mode == "rich":
+        assert result_lines[first_index + 2] == "This is the first conclusion"
+        assert result_lines[first_index + 3] == "Here is conclusion two"
+        assert result_lines[first_index + 4] == ""
+        assert result_lines[first_index + 5] == "That's all folks!"
+    else:
+        assert (
+            result_lines[first_index + 2]
+            == "This is the first conclusion Here is conclusion two"
+        )
+        assert result_lines[first_index + 3] == ""
+        assert result_lines[first_index + 4] == "That's all folks!"

typer/__init__.py

@@ -1,6 +1,6 @@
 """Typer, build great CLIs. Easy to code. Based on Python type hints."""
 
-__version__ = "0.27.0"
+__version__ = "0.27.1"
 
 from shutil import get_terminal_size as get_terminal_size
 

typer/rich_utils.py

@@ -221,8 +221,7 @@ def _get_help_text(
     if remaining_paragraphs:
         # Add a newline inbetween the header and the remaining paragraphs
         yield Text("")
-        # Join with double linebreaks for markdown and Rich markup
-        remaining_lines = "\n\n".join(remaining_paragraphs)
+        remaining_lines = _fix_linebreaks(remaining_paragraphs, markup_mode)
 
         yield _make_rich_text(
             text=remaining_lines,
@@ -231,6 +230,11 @@ def _get_help_text(
         )
 
 
+def _fix_linebreaks(paragraphs: list[str], markup_mode: MarkupModeStrict) -> str:
+    # Join with double linebreaks for markdown and Rich markup
+    return "\n\n".join(paragraphs)
+
+
 def _get_parameter_help(
     *,
     param: TyperOption | TyperArgument | _click.Parameter,
@@ -666,7 +670,7 @@ def rich_format_help(
     if obj.epilog:
         # Remove single linebreaks, replace double with single
         lines = obj.epilog.split("\n\n")
-        epilogue = "\n".join([x.replace("\n", " ").strip() for x in lines])
+        epilogue = _fix_linebreaks(lines, markup_mode)
         epilogue_text = _make_rich_text(text=epilogue, markup_mode=markup_mode)
         console.print(Padding(Align(epilogue_text, pad=False), 1))