Advertising
Advertising

Use Markdown For Easy Web Writing

Use Markdown For Easy Web Writing

    In listening to a bunch of Mac-centric podcasts lately, especially on workflows with the Mac, I have come across a tool that has been around for a while but is still not extremely popular with everyone. The tool is called Markdown and was created by John Gruber (Daring Fireball fame). The best way to explain it is the first paragraph from Markdown’s description on Mr. Gruber’s page:

    Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

    Yeah that is it in a nutshell. Before I jump in how to use this awesome tool on Mac and Windows, you may be wondering what the point of a tool like this actually is.

    What’s the point?

    At first I didn’t get the reason for using Markdown. Cool, you can transfer plain text stuff into HTML, but who the hell uses HTML anymore? Well, if you are a web writer you use HTML every single day whether you know it or not and if you have used WordPress or any other CMS for any length of time you have most likely had to tweak some HTML.

    If you are using WordPress there is nothing more agrevating than the WYSIWYG editor becoming too helpful with HTML tags in the background essentially destorying your formatting. Markdown can help you by transforming your text file into valid HTML. This allows you to paste your HTML into the HTML editor thus keeping your hard-won formatting. So nice.

    Advertising

    Also, there is something to say for document portability. HTML is an agnostic type of document markup and can be rendered in pretty much any crappy web browser. With the continued use of many different operating systems and devices out in the wild (iOS, Android, Blackberry, Windows, Mac, Linux, etc) the need for a standard format for text is highly needed. Markdown helps this along by allowing you to standardized all your note formatting without locking you in to some proprietary format. Just HTML and txt files.

    Let’s use it, shall we?

    Markdown is pretty darn easy to use and if you have any experience messing aroudn with software and HTML it will be a snap. Markdown is written in Perl, so if you don’t have Perl on your Windows machine you can download and install Strawberry Perl from here. If you are a Mac user, Perl is already installed for you.

    Next, go over to Daring Fireball and grab the Markdown.pl script, unzip it and put the Markdown.pl file in the directory that you will use to create and tranform your input text files.

    Now the fun part; learning how to use the syntax and creating your input text file.

    Markdown syntax

    I am going to briefly explain some of the most used syntax snippets that will get you off an running with Markdown. If you want the whole shebang, head on over to Daring Fireball to get a detailed list of all the niceties of the Markdown syntax.

    Headers

    Headers tags (h1, h2, h3, etc) are simple to create in your text document. To signify the h1 tag, “underline” the text with the ‘=’ sign:

    Advertising

    This is a h1 header
    ===================
    

    or for h2 use the ‘-‘ character:

    This is a h2 header
    -------------------
    

    You don’t need to put the same amount of ‘=’ or ‘-‘ characters under the heading; any number will due to produce the header tags.

    Bullets and lists

    I think in bullets and lists so it’s nice that Markdown handles them well. To insert a bullet append an asterisk to your line like this:

    * This is my point
    

    You can also use the ‘+’ or ‘-‘ characters as bullets.

    Ordered lists are easy too:

    1. Number one
    2. Number two
    3. Number three... now you got it!
    

    If you want multiple paragraphs under a bullet or number just indent the first line of each paragraph or indent all the lines if you want it to look nicer:

    Advertising

    1. Here is the first point that I am trying to make about numbered lists.
    
       By the way, I should probably mention this too.
    
    2. Next point
    

    Links

    One of my favorite things of Markdown is the easy way to insert links. First, bracket the word or phrase that you would like to be “clickable” and then follow that by a parenthesized URL:

    [click here](http://www.google.com/)
    

    Outputting to HTML

    After you have created your text file it is now time to pass it to the Markdown.pl script to produce your HTML output. If you didn’t create a text file to test, you can download the quick text file that I created to try it out.

    Place your text file in the same directory as the Markdown.pl script (you can pass the arguments with the correct path if you want to, this is just to make it easier). After that is done open up your command prompt in Windows or your terminal on your Mac or Linux and navigate to the folder with your input file.

    To create the output directly in the terminal window use the following command:

    perl Markdown.pl input.txt

    This will then parse the text file and output the valid HTML markup to the terminal. If you want the ouput to be directed towards a totally seperate HTML file type the following command:

    Advertising

    perl Markdown.pl input.txt > output.html

    This will create the HTML file output.html in whatever directory you are currently in.

    Wrapping it up

    Let me just say that if you think Markdown is interesting and understand the utility of it, I highly suggest that if you write anything you should write it with Markdow

    n syntax. It is cross-platform, open source, free, and compatible with everything. To me it is a game changer and I feel like I am a little behind in not utilizing it sooner. Once again, there is much more to the syntax than I have highlighted here, so check out Daring Fireball for more.

    By the way, I wrote this entire article using Markdown and if you want to see the syntax you can download it here.

    More by this author

    CM Smith

    A technologist and writer who shares advice on personal productivity, creativity and how to use technology to get things done.

    Design Is Important: How To Fail At Blogging 7 Tools to Help Keep Track of Goals and Habits Effectively 6 Unexpected Ways Journaling Every Day Will Make Your Life Better Why Getting Things Done is the Best Productivity System For You How to Beat Procrastination: 29 Ways to Beat It Once and for All To Automate or not to Automate Your Personal Productivity System

    Trending in Productivity

    1 How to Be a Leader Who Is Inspiring and Influential 2 Killer Cover Letter Tips to Nail Every Interview Opportunity 3 How to Get out of a Rut: 12 Useful Ways to Get Unstuck 4 How to Use Sticky Notes for More Productive Reading And Learning 5 10 Best Time Management Books Recommended By Great Entrepreneurs

    Read Next

    Advertising
    Advertising
    Advertising

    Last Updated on March 15, 2019

    How to Be a Leader Who Is Inspiring and Influential

    How to Be a Leader Who Is Inspiring and Influential

    When I began managing people 15 years ago, I thought having a fancy title was synonymous with influence. Over time, I learned that power is conferred based on likeability, authenticity, courage, relationships and consistent behavior. When leaders cultivate these attributes, they earn power, which really means influence.

    Understanding influence is essential to professional growth, and companies rise and fall based on the quality of their leadership.

    In this article, we will look into the essentials of effective leadership and how to be a leader who is inspiring and influential.

    What Makes a Leader Fail?

    A host of factors influence a leader’s ability to succeed. To the extent that leaders fail to outline a compelling vision and strategy, they risk losing the trust and confidence of their teams. Employees want to know where a company is going and the strategy for how they will get there. Having this information enables employees to feel safe, and it allows them to see mistakes as part of the learning journey versus as fatal occurrences.

    If employees and customers do not believe a company’s leadership is authentic and inspiring, they may disengage, or they may be less inclined to offer constructive criticism that can help a company innovate or help a leader improve.

    And it is not just the leadership at the top that matters. Middle managers play a distinct role in guiding teams. Depending on the company’s size, employees may have more access to mid-level managers than they do members of the C-suite, meaning their supervisors and managers have greater influence on the employee and the customer experience.

    What Is Effective Leadership?

    Effective leadership is inspiring, and it is influential. Cultivating inspiring and influential leaders requires building relationships across the company.

    Leaders must be connected to both the teams they lead as well as to their own colleagues and managers. This is key as titles do not make a person a leader, nor do they automatically confer influence. These are earned through trusting relationships. This explains why some leaders can get more out of their teams than others and why some leaders experience soaring profits and engagement while others sizzle out.

    Eric Garton said in an April 25, 2017, Harvard Business Review article:[1]

    Advertising

    “… inspiring leaders are those who use their unique combination of strengths to motivate individuals and teams to take on bold missions – and hold them accountable for results. And they unlock higher performance through empowerment, not command and control.”

    How to Be an Inspiring and Influential Leader

    To be an inspiring and influential leader requires:

    1. Courage

    The late poet Maya Angelou once said,

    “Courage is the most important of all the virtues, because without courage you can’t practice any other virtue consistently. You can practice any virtue erratically, but nothing consistently without courage.”

    Courage is required in the workplace when implementing new strategies, especially when they go against professional norms.

    For instance, I heard Lisa TerKeurst, bestselling author and founder of Proverbs 31 Ministries, explain her decision to move away from her company’s magazine. While the organization had long had a magazine, she saw a future where it didn’t exist.

    In order to make the switch, she risked angering her team members and customers. She took a chance, and what started out as a monthly newsletter, has grown into a multi-dimensional organization boasting half a million followers. Had Lisa not found the courage to change the direction of her organization, they undoubtedly would not have been able to experience such exponential growth.

    It also takes courage to give and receive feedback. When leaders see employees who are not living into the company’s mission or who are engaging in behavior that may undermine their long-term success, one must risk temporary angst and speak candidly with the colleague in question.

    Similarly, it takes courage to hear constructive criticism and try to change. In business, as in life, courage is necessary for being an inspiring and influential leader.

    Advertising

    2. A Commitment to Face Your Internal Demons.

    If you feel great about yourself, enter a leadership position. You are likely to be triggered in ways you didn’t think possible. You are also likely to receive feedback that may leave you second-guessing yourself and your leadership skills.

    The truth about leading others is that you get to a point where you realize that it is difficult to take people to places where you yourself haven’t gone.

    To be an influential and inspiring leader, you have to face your own demons and vow to continually improve. Influential leaders take their personal evolution serious, and they invest in coaching, therapy and mindfulness to ensure that their personal struggles do not overshadow their professional development.

    3. A Willingness to Accept Feedback

    Inspiring and influential leaders are not afraid to accept feedback. In fact, they actively solicit it. They understand that everyone in their life has a lesson to teach them, and they are willing to accept it.

    Inspirational leaders understand that feedback is neither good nor bad but rather an offering that is critical to growth. Even when it hurts or is an affront to the ego, influential leaders understand that feedback is critical to their ability to lead.

    4. Likability

    Some people will argue that leaders need not worry about being liked but should instead focus on being respected. I disagree. Both are important.

    When team members like their boss and believe their boss likes them, they are more likely to go the extra mile to fulfill departmental or organizational goals. Likable leaders are moved to the front of the line when it comes to being influential.

    Relatedly, when colleagues feel management dislikes them, they experience internal stress and can spend unnecessary time focusing on the source of their manager’s discontent versus the work they have been hired to do.

    So, likability is important for both the leader and the people she leads.

    Advertising

    5. Vulnerability

    Vulnerability is critical for being an inspiring leader. People want the truth. They admire leaders who can occasionally demonstrate vulnerability. It promotes deeper relationships and inspires trust.

    When leaders can showcase vulnerability appropriately, they destroy the illusion that one must be perfect to be a leader. They also demonstrate that vulnerability is not a dirty word; they too can be vulnerable and ask for a helping hand when necessary.

    6. Authenticity

    Authenticity is about living up to one’s stated values in public and behind closed doors.

    Influential leaders are authentic. They set to live out their values and use those values to guide their decisions. The interesting thing about leadership is that people are not looking for perfect leaders. They are, in part, looking for leaders who are authentic.

    7. A True Understanding of Inspiration

    Effective leaders are inspirational. They understand the power of words and deeds and use both strategically.

    Inspiring leaders appropriately use stories and narratives to enable the teams around them to see common situations in an entirely new light.

    Inspirational leaders also showcase grit and triumph while convincing the people around them that success and victory are attainable.

    Finally, inspiring leaders encourage the teams they lead to tap into their own genius. They convince others that genius is not reserved for a select few but that most people have it in them.

    As explained in the article True Leadership: What Separates a Leader from a Boss:

    Advertising

    “A leader creates visions and motivates team members to work together towards the same goal.”

    8. An Ability to See the Humanity in Others

    Inspiring and influential leaders see the humanity in others. Rather than treating their teams as mere tools to accomplish organizational goals, they believe the people around them are unique beings with inherent value.

    This means knowing when to pause to address personal challenges and dispelling with the myth that the personal is separate from the professional.

    9. A Passion for Continual Learning

    Inspiring and influential leaders are committed to continual learning. They invest in their own development and take responsibility for their professional growth.

    These leaders understand that like a college campus, the workplace is a laboratory for learning. They believe that they can learn from multiple generations in the workplace as well as from people from diverse racial and ethnic backgrounds.

    Influential leaders proactively seek out opportunities for learning.

    The Bottom Line

    No one said leadership was easy, but it is also a joy. Influencing others to action and positively impacting the lives of others is a reward unto itself.

    Since leadership abounds, there is an abundance of resources to help you grow into the type of leader who inspires and influences others.

    More Resources About Effective Leadership

    Featured photo credit: Markus Spiske via unsplash.com

    Reference

    [1] Harvard Business Review: How to Be an Inspiring Leader

    Read Next