Using Mermaid in Markdown

-

    I have been using Typora Markdown Editor for some time now, and I am relatively a novice compared to the people who are using it for several years. Now I want to try some advanced functions, and Janne Kemppainen's blog (https://pakstech.com/about/) helped me do the same. I learned the basics of using Mermaid to create diagrams and visualizations using text and code. Like me, you can visit the Mermaid site (https://mermaid-js.github.io/mermaid/#/) to teach yourself the ways to use this open-source software.

Here is a sample for inserting a pie chart:

'''mermaid

pie title NETFLIX

        "Looking for movie" : 90

        "Watching it" : 10

'''

The diagram generated is as in the following:

Related articles:

 The ability to learn is the key to survival. We can learn faster by learning from each other.

Comments

Post a Comment

Popular posts from this blog

Insert images in Typora

-
Image
     I started toying with the idea of using Markdown for documentation only a couple of months ago and happened to pick Typora as my choice of Markdown Editor. You can tutor this tool by yourself in a single day, but it takes time to learn some nuances if you are learning it all by yourself. For a long time, I thought Typora doesn't have the option to add a cover page, header, footer, and page numbers, and last week I figured out that we can do all these by using the YAMAL front matter. You can add typora-root-url to the YAMAL front matter to insert images by their relative path. To know more, see: https://support.typora.io/YAML/ https://support.typora.io/Images/ Related articles: YAMAL front matter in Typora Use markdown for your README Why I am gung-ho about Typora Conditional text in markdown Author documents using markdown Using mermaid in markdown Do agile technical documentation using markdown Tool independent technical documentation Techniques for cost-effective ...
Read more

Apply Goldilocks principle

-
Image
     There is one thing universal about successful managers. They keep increasing the performance benchmark every time. It applies to an athletic coach who wants to make his trainee globally competitive. I have worked under cruelly kind managers who are very ruthless in getting the tasks done. They push you to improve your competency and skills every day. You may have had a tough time working under this manager, and still, it is not something to be resented. Weathers the pressures work? We start looking for ways to do things better when the competitive edge is so narrow, and even a marginal improvement in something will give you an edge over your competitors. I had my dilemmas over if harsh managers are good or bad. A good manager sets difficult but attainable benchmarks and allows members to execute tasks with relative autonomy. There is no use flogging a dead horse. Spend time grooming the people who are motivated to do their best. I have spent time with people who do n...
Read more

Technical Writing essentials

-
Image
     I want to share some of my learnings starting from the beginning days of my Technical Writing career. Everyone in the project must have a cursory understanding of the following, and the Technical Writer must understand it in detail: Language standards Learn the style guides. MSTP (Microsoft Manual of Style - currently called Microsoft Style Guide) is among the most widely followed style guides. You can access it online for free and even download the PDF for offline reference. See https://docs.microsoft.com/en-us/style-guide/welcome/ There are several other style guides, but it is mostly enough to refer only to Microsoft Style Guide. The following are some of the key takeaways: Avoid passive voice - sentences in passive voice are generally longer and harder to read. Use only the simple and easy words understood by the global audience with varying degrees of English knowledge. Your writing must have the same meaning for all people from different geographies and culture...
Read more