chore: improve clarity and formatting in PDF text manipulation documentation

Author: andruhovski

en/python-net/advanced-operations/working-with-text/add-text-to-pdf-file/_index.md

@@ -22,10 +22,10 @@ Aspose.PDF for Python via .NET. shows how to add a simple text fragment to a spe
 
 1. Create a new Document object
 1. Use 'document.pages.add()' to create a new blank page.
-1. Create a TextFragment().
-1. Set the text position using the Position() class. If you specify Position(), the text will be located in your document from left to right and shifted downwards.
+1. Create a `TextFragment`.
+1. Set the text position using the Position class. If you specify Position, the text will be located in your document from left to right and shifted downwards.
 1. Customize text appearance. You can set font size, color, font style, and more via text_fragment.text_state.
-1. Append the TextFragment to the page’s paragraph collection with page.paragraphs.add(text_fragment).
+1. Append the TextFragment to the page’s paragraph collection with `page.paragraphs.add(text_fragment)`.
 1. Save the document.
 
 The following code snippet shows you how to add text in an existing PDF file:
@@ -126,7 +126,7 @@ Additionally, this code snippet shows how to use multiple text segments within a
     document.save(path_outfile)
 ```
 
-[![Add Text with Font Styling](styled_text.png)]
+![Text fragment displayed with blue italic Arial font containing the text Hello, Aspose! followed by a mathematical formula showing S = a subscript 2n + a subscript 2n+1 + a subscript 2n+2 with blue main text and red subscript formatting](styled_text.png)
 
 ### Add Right-to-Left (RTL) Text to PDF Document
 
@@ -162,7 +162,7 @@ Set font and styling. Choose a font that supports the RTL script (e.g., Tahoma,
     document.save(path_outfile)
 ```
 
-[![Right-to-Left Text](rtl_text.png)]
+![Right-to-Left Text](rtl_text.png)
 
 ### Add Text with Hyperlinks
 
@@ -204,7 +204,7 @@ Add clickable hyperlinks to text in a PDF using Aspose.PDF for Python via .NET.
     document.save(path_outfile)
 ```
 
-[![Text with Hyperlinks](hyperlink_text.png)]
+![Text fragment displayed in a PDF showing mixed content with Sample Text Fragment followed by Text Segment 1, then a blue hyperlinked text reading Link to Google, and ending with TextSegment without hyperlink in regular black text formatting](hyperlink_text.png)
 
 ## Add Text transparent
 
@@ -304,7 +304,7 @@ Create a TextParagraph. You can set wrap mode. In this example, we use the 'DISC
     document.save(path_outfile)
 ```
 
-[![Add Text using TextParagraph](text_paragraph.png)]
+![Add Text using TextParagraph](text_paragraph.png)
 
 ### Add Text with Indents in PDF
 
@@ -316,16 +316,14 @@ It shows how to control both the first line indent and the subsequent line inden
 1. Create and style a text fragment. Use TextFragment(text) to hold the content. Apply basic styling (font and size) via the text_state property.
 1. Initialize a TextBuilder. It used to place TextParagraph objects on a page.
 1. Add the first paragraph with 'first_line_indent'. It offsets only the first line of the paragraph. The rectangle defines the area where text will appear. Use 'wrap_mode = BY_WORDS' to ensure natural word wrapping.
-1. Add a second paragraph with 'subsequent_lines_indent'. It offsets all lines after the first.
+1. Add a second paragraph with `subsequent_lines_indent`. It offsets all lines after the first.
 1. Save the document.
 
 You can also modify:
 
-- 'fragment.text_state.foreground_color' - for text color.
-
-- 'fragment.text_state.font_style' - for bold/italic/underline.
-
-- 'fragment.text_state.line_spacing' - for spacing between lines.
+- `fragment.text_state.foreground_color` - for text color.
+- `fragment.text_state.font_style` - for bold/italic/underline.
+- `fragment.text_state.line_spacing` - for spacing between lines.
 
 ```python
 
@@ -396,7 +394,7 @@ Aspose.PDF for Python via .NET library allows you to insert HTML-formatted conte
     document.save(path_outfile)
 ```
 
-[![Add HTML Text to a PDF Document](html_fragment.png)]
+![Add HTML Text to a PDF Document](html_fragment.png)
 
 ### Add LaTeX Text to PDF Document
 
@@ -426,7 +424,7 @@ LaTeX is a powerful typesetting system widely used for creating scientific and m
     document.save(path_outfile)
 ```
 
-[![Add LaTeX Text to a PDF Document](latex_fragment.png)]
+![Add LaTeX Text to a PDF Document](latex_fragment.png)
 
 ### Add HTML Fragment to PDF Document
 
@@ -459,7 +457,7 @@ We can define an HTML fragment and set the text style directly using HTML tags.
     document.save(path_outfile)
 ```
 
-[![Add HTML Content to a PDF Document](html_content.png)]
+![Add HTML Content to a PDF Document](html_content.png)
 
 ### Add HTML Fragment override text state
 
@@ -497,7 +495,7 @@ Insert styled HTML content into a PDF document, while overriding the default tex
     document.save(path_outfile)
 ```
 
-[![Add HTML fragment override text state](html_override.png)]
+![Add HTML fragment override text state](html_override.png)
 
 ## Using Line Spacing
 
@@ -589,7 +587,7 @@ The example shows how line spacing behavior can vary depending on the selected m
     document.save(path_outfile)
 ```
 
-[![Custom Line Spacing](line_spacing.png)]
+![Custom Line Spacing](line_spacing.png)
 
 ## Using Character Spacing
 
@@ -628,7 +626,7 @@ Character spacing determines the distance between individual characters in a lin
     document.save(path_outfile)
 ```
 
-[![Character Spacing](character_spacing_simple.png)]
+![Character Spacing](character_spacing_simple.png)
 
 ### How to control character spacing in PDF text using the TextParagraph and TextBuilder
 
@@ -795,11 +793,11 @@ Our library shows how to create a bulleted (unordered) list in a PDF document us
     document.save(path_outfile)
 ```
 
-[![Bullet list HTML](bullet_list_html.png)]
+![Bullet list HTML](bullet_list_html.png)
 
 ### Create numbered list HTML version
 
-Create a numbered (ordered) list in a PDF document using HTML fragments. It converts a Python list of strings into an HTML <ol> element and inserts it into a PDF page as an HtmlFragment.
+Create a numbered (ordered) list in a PDF document using HTML fragments. It converts a Python list of strings into an HTML `<ol>` element and inserts it into a PDF page as an HtmlFragment.
 
 Using HTML fragments enables you to incorporate HTML-based formatting features, such as numbered lists, bold, italics, and more, directly in your PDF.
 
@@ -833,7 +831,7 @@ Using HTML fragments enables you to incorporate HTML-based formatting features,
     document.save(path_outfile)
 ```
 
-[![Numbered list HTML ](numbered_list_html.png)]
+![Numbered list HTML ](numbered_list_html.png)
 
 ### Create a bullet list LaTeX version
 
@@ -869,7 +867,7 @@ Create a bulleted (unordered) list in a PDF using LaTeX fragments (TeXFragment).
     document.save(path_outfile)
 ```
 
-[![Bullet list LaTex](bullet_list_latex.png)]
+![Bullet list LaTex](bullet_list_latex.png)
 
 ### Create numbered list LaTeX version
 
@@ -903,7 +901,7 @@ Create a numbered (ordered) list in a PDF using LaTeX fragments (TeXFragment). I
     document.save(path_outfile)
 ```
 
-[![Numbered list LaTex](numbered_list_latex.png)]
+![Numbered list displayed in PDF showing LaTeX-rendered formatting with items 1. First item, 2. Second item with more text to demonstrate wrapping behavior, 3. Third item, and 4. Fourth item, preceded by the text Lists are easy to create](numbered_list_latex.png)
 
 ## Using Custom Fonts