--- a/apisupport.wizards/src/org/netbeans/modules/apisupport/project/ui/wizard/javahint/NewJavaHintIterator.java	
+++ a/apisupport.wizards/src/org/netbeans/modules/apisupport/project/ui/wizard/javahint/NewJavaHintIterator.java	
@@ -172,7 +172,7 @@ 
         replaceTokens.put("PACKAGE_NAME", model.getPackageName()); // NOI18N
         replaceTokens.put("GENERATE_FIX", model.isDoFix() ? "true" : null); // NOI18N
         replaceTokens.put("DISPLAY_NAME", model.getDisplayName()); // NOI18N
-        replaceTokens.put("DESCRIPTION", model.getDescription()); // NOI18N
+        replaceTokens.put("DESCRIPTION", replaceLineBreaksWithHTMLLineBreaks(model.getDescription())); // NOI18N
         replaceTokens.put("WARNING_MESSAGE", model.getWarningMessage()); // NOI18N
         if (model.isDoFix()) {
             replaceTokens.put("FIX_MESSAGE", model.getFixText()); // NOI18N
@@ -195,6 +195,12 @@ 
         model.setCreatedModifiedFiles(cmf);
     }
 
+    private static String replaceLineBreaksWithHTMLLineBreaks(String text) {
+        String result = null != text ? text : "";
+        result = result.trim().replaceAll("(\r?\n|\r)(?=.)", "<br/>\" +\n\""); // NOI18N
+        return result;
+    }
+    
     private static NbProjectProvider getProjectProvider(Project prj) {
             return prj.getLookup().lookup(NbProjectProvider.class);
     }