[Improvement]: Make the content of generated md files to be markdown compatible

[TharmiganK]

Description

We can create a ballerina library package using the following command:

$ bal new -t lib socialMedia

This creates the module.md and package.md with the content which is not markdown compatible

Describe your problem(s)

The generated md file has the following line which is not markdown compatible:

Prints "Hello, World!" with a main function.
[//]: # (above is the package summary)

Describe your solution(s)

Generate some descriptive sample which is markdown compatible

Related area

-> Other Area

Related issue(s) (optional)

No response

Suggested label(s) (optional)

No response

Suggested assignee(s) (optional)

No response

[lwpamihiranga]

Hi,

I've noticed that these .md files are not generated in the master branch build, but they are available when tested with Ballerina version 2201.9.1 (Swan Lake Update 9). Could you please let me know which branch would be the most appropriate for me to apply the fix to?

Thanks!