Make the content of generated md files to be markdown compatible

cli/ballerina-cli/src/main/resources/new_cmd_defaults/README.md

@@ -1,5 +1,47 @@
-Prints "Hello, World!" with a hello function.
-[//]: # (above is the package summary)
-
 # Package Overview
-Prints "Hello, World!" as the output to the command line using a hello function.
+
+This package provides a simple utility function to print "Hello, World!" to the command line. It also supports personalized greetings by optionally accepting a name.
+
+## Build from Source and Publish
+
+### Build the Package
+
+To build the package locally, execute the following command in the terminal:
+
+```bash
+bal pack
+```
+
+This command compiles the package and prepares it for use or distribution.
+
+### Publish the Package
+
+To publish the package to a local repository, use the following command:
+
+```bash
+bal push --repository=local
+```
+
+## Usage
+
+To use the user/socialMedia package in your Ballerina project, import it along with the ballerina/io module for output handling.
+(Note: For this example, we are assuming the organization name is `user` and the package name is `socialMedia`.)
+
+```ballerina
+import ballerina/io;
+import user/socialMedia;
+
+public function main() {
+    string greeting = socialMedia:hello("Ballerina");
+    io:println(greeting); // Output: Hello, Ballerina
+}
+```
+
+The `hello` function can be called without any arguments to get the default greeting:
+
+```ballerina
+public function main() {
+    string greeting = socialMedia:hello();
+    io:println(greeting); // Output: Hello, World!
+}
+```