Partner – Moderne – NPI EA (cat=Spring Boot)
announcement - icon

Refactor Java code safely — and automatically — with OpenRewrite.

Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.

Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.

Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.

Course – Black Friday 2026 – NPI EA – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

1. Overview

In this tutorial, we’ll look briefly at the different ways of preserving line breaks when using Jsoup to parse HTML to plain text. We will cover how to preserve line breaks associated with newline (\n) characters, as well as those associated with <br> and <p> tags.

2. Preserving \n While Parsing HTML Text

Jsoup removes the newline character (\n) by default from the HTML text and replaces each newline with a space character.

However, to prevent Jsoup from removing the newline characters, we can change the OutputSetting of Jsoup and disable pretty-print. If pretty-print is disabled, the HTML output methods will not re-format the output, and the output will look like the input:

Document.OutputSettings outputSettings = new Document.OutputSettings();
outputSettings.prettyPrint(false);

Furthermore, we can use Jsoup#clean to remove all the HTML tags from the string:

String strHTML = "<html><body>Hello\nworld</body></html>";
String strWithNewLines = Jsoup.clean(strHTML, "", Safelist.none(), outputSettings);

Let’s see what our output string strWithNewLines looks like:

assertEquals("Hello\nworld", strWithNewLines);

Therefore, we can see that by calling Jsoup#clean with Safelist#none and disabling the pretty-print output setting of Jsoup, we are able to preserve the line breaks associated with the newline character.

Let’s see what else we can do!

3. Preserving Line Breaks Associated with <br> and <p> Tags

While cleaning the HTML text using the Jsoup#clean method, it removes the line breaks created by HTML tags like <br> and <p>.

To preserve the line breaks associated with these tags, we first need to create a Jsoup Document from our HTML string:

String strHTML = "<html><body>Hello<br>World<p>Paragraph</p></body></html>";
Document jsoupDoc = Jsoup.parse(strHTML);

Next, we prepend a newline character before the <br> and <p> tags — once again, we’re disabling the pretty-print output setting as well:

Document.OutputSettings outputSettings = new Document.OutputSettings();
outputSettings.prettyPrint(false);
jsoupDoc.outputSettings(outputSettings);
jsoupDoc.select("br").before("\\n");
jsoupDoc.select("p").before("\\n");

Here, we used the select method of Jsoup Document along with the before method to prepend the newline character.

After that, we get the HTML string from jsoupDoc retaining the original new lines:

String str = jsoupDoc.html().replaceAll("\\\\n", "\n");

Finally, we call Jsoup#clean with Safelist#none and the pretty-print output setting disabled:

String strWithNewLines = Jsoup.clean(str, "", Safelist.none(), outputSettings);

And our output string strWithNewLines looks like:

assertEquals("Hello\nWorld\nParagraph", strWithNewLines);

Thus, by prepending <br> and <p> HTML tags with the newline character, and disabling the pretty-print output setting of Jsoup, we can preserve the line breaks associated with them.

4. Conclusion

In this short article, we learned how to preserve line breaks associated with newline (\n) characters and the <br> and <p> tags when parsing HTML into plain text with Jsoup.

The code backing this article is available on GitHub. Once you're logged in as a Baeldung Pro Member, start learning and coding on the project.
Partner – Moderne – NPI EA (tag=Refactoring)
announcement - icon

Modern Java teams move fast — but codebases don’t always keep up. Frameworks change, dependencies drift, and tech debt builds until it starts to drag on delivery. OpenRewrite was built to fix that: an open-source refactoring engine that automates repetitive code changes while keeping developer intent intact.

The monthly training series, led by the creators and maintainers of OpenRewrite at Moderne, walks through real-world migrations and modernization patterns. Whether you’re new to recipes or ready to write your own, you’ll learn practical ways to refactor safely and at scale.

If you’ve ever wished refactoring felt as natural — and as fast — as writing code, this is a good place to start.

Course – Black Friday 2026 – NPI EA – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW