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.

    5 Project Management Tools to Get Your Team on Track To Automate or not to Automate Your Personal Productivity System How to Beat Procrastination: 29 Simple Tweaks to Make 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

    Trending in Productivity

    1 Why Your Habits Hinder You From Reaching Your Goals 2 We Do What We Know Is Bad for Us, Why? 3 13 Bad Habits You Need to Quit Right Away 4 How to Reprogram Your Brain Like a Computer And Hack Your Habits 5 14 Ideas on How to Measure Productivity to Make Progress

    Read Next

    Advertising
    Advertising
    Advertising

    Last Updated on January 6, 2021

    14 Ideas on How to Measure Productivity to Make Progress

    14 Ideas on How to Measure Productivity to Make Progress

    Everyone has heard the term productivity, and people talk about it in terms of how high it is and how to improve it. But fewer know how to measure productivity, or even what exactly we are talking about when using the term “productivity.”

    In its simplest form, the productivity formula looks like this: Output ÷ Input = Productivity.

    For example, you have two salespeople each making 10 calls to customers per week. The first one averages 2 sales per week and the second one averages 3 sales per week. By plugging in the numbers we get the following productivity levels for each sales person.

    For salesperson one, the output is 2 sales and the input is 10 sales: 2 ÷ 10 = .2 or 20% productivity. For salesperson two, the output is 3 sales and the input is 10 sales: 3 ÷ 10 = .3 or 30% productivity.

    Knowing how to measure and interpret productivity is an invaluable asset for any manager or business owner in today’s world. As an example, in the above scenario, salesperson #1 is clearly not doing as well as salesperson #2.

    Knowing this information we can now better determine what course of action to take with salesperson #1.

    Some possible outcomes might be to require more in-house training for that salesperson, or to have them accompany the more productive salesperson to learn a better technique. It might be that salesperson #1 just isn’t suited for sales and would do a better job in a different position.

    How to Measure Productivity With Management Techniques

    Knowing how to measure productivity allows you to fine tune your business by minimizing costs and maximizing profits:

    1. Identify Long and Short-Term Goals

    Having a good understanding of what you (or your company’s) goals are is key to measuring productivity.

    For example, if your company’s goal is to maximize market share, you’ll want to measure your team’s productivity by their ability to acquire new customers, not necessarily on actual sales made.

    2. Break Down Goals Into Smaller Weekly Objectives

    Your long-term goal might be to get 1,000 new customers in a year. That’s going to be 20 new customers per week. If you have 5 people on your team, then each one needs to bring in 4 new customers per week.

    Now that you’ve broken it down, you can track each person’s productivity week-by-week just by plugging in the numbers:

    Advertising

    Productivity = number of new customers ÷ number of sales calls made

    3. Create a System

    Have you ever noticed that whenever you walk into a McDonald’s, the French fry machine is always to your left? 

    This is because McDonald’s created a system. They have determined that the most efficient way to set up a kitchen is to always have the French fry machine on the left when you walk in.

    You can do the same thing and just adapt it to your business.

    Let’s say that you know that your most productive salespeople are making the most sales between the hours of 3 and 7 pm. If the other salespeople are working from 9 am to 4 pm, you can potentially increase productivity through something as simple as adjusting the workday.

    Knowing how to measure productivity allows you to set up, monitor, and fine tune systems to maximize output.

    4. Evaluate, Evaluate, Evaluate!

    We’ve already touched on using these productivity numbers to evaluate and monitor your employees, but don’t forget to evaluate yourself using these same measurements.

    If you have set up a system to track and measure employees’ performance, but you’re still not meeting goals, it may be time to look at your management style. After all, your management is a big part of the input side of our equation.

    Are you more of a carrot or a stick type of manager? Maybe you can try being more of the opposite type to see if that changes productivity. Are you managing your employees as a group? Perhaps taking a more one-on-one approach would be a better way to utilize each individual’s strengths and weaknesses.

    Just remember that you and your management style contribute directly to your employees’ productivity.

    5. Use a Ratings Scale

    Having clear and concise objectives for individual employees is a crucial part of any attempt to increase workplace productivity. Once you have set the goals or objectives, it’s important that your employees are given regular feedback regarding their progress.

    Using a ratings scale is a good way to provide a standardized visual representation of progress. Using a scale of 1-5 or 1-10 is a good way to give clear and concise feedback on an individual basis.

    Advertising

    It’s also a good way to track long-term progress and growth in areas that need improvement.

    6. Hire “Mystery Shoppers”

    This is especially helpful in retail operations where customer service is critical. A mystery shopper can give feedback based on what a typical customer is likely to experience.

    You can hire your own shopper, or there are firms that will provide them for you. No matter which route you choose, it’s important that the mystery shoppers have a standardized checklist for their evaluation.

    You can request evaluations for your employees friendliness, how long it took to greet the shopper, employees’ knowledge of the products or services, and just about anything else that’s important to a retail operation.

    7. Offer Feedback Forms

    Using a feedback form is a great way to get direct input from existing customers. There are just a couple of things to keep in mind when using feedback forms.

    First, keep the form short, 2-3 questions max with a space for any additional comments. Asking people to fill out a long form with lots of questions will significantly reduce the amount of information you receive.

    Secondly, be aware that customers are much more likely to submit feedback forms when they are unhappy or have a complaint than when they are satisfied.

    You can offset this tendency by asking everyone to take the survey at the end of their interaction. This will increase compliance and give you a broader range of customer experiences, which will help as you’re learning how to measure productivity.

    8. Track Cost Effectiveness

    This is a great metric to have, especially if your employees have some discretion over their budgets. You can track how much each person spends and how they spend it against their productivity.

    Again, this one is easy to plug into the equation: Productivity = amount of money brought in ÷ amount of money spent.

    Having this information is very useful in forecasting expenses and estimating budgets.

    9. Use Self-Evaluations

    Asking your staff to do self evaluations can be a win-win for everyone. Studies have shown that when employees feel that they are involved and their input is taken seriously, morale improves. And as we all know, high employee morale translates into higher productivity.

    Advertising

    Using self-evaluations is also a good way to make sure that the employees and employers goals are in alignment.

    10. Monitor Time Management

    This is the number one killer of productivity in the workplace. Time spent browsing the internet, playing games, checking email, and making personal calls all contribute to lower productivity[1].

    Time Management Tips to Improve Productivity

      The trick is to limit these activities without becoming overbearing and affecting morale. Studies have shown that most people will adhere to rules that they feel are fair and applied to everyone equally.

      While ideally, we may think that none of these activities should be done on company time, employees will almost certainly have a different opinion. From a productivity standpoint, it is best to have policies and rules that are seen as fair to both sides as you’re learning how to measure productivity.

      11. Analyze New Customer Acquisition

      We’ve all heard the phrase that “It’s more expensive to get a new customer than it is to keep an existing one.” And while that is very true, in order for your business to keep growing, you will need to continually add new customers.

      Knowing how to measure productivity via new customer acquisition will make sure that your marketing dollars are being spent in the most efficient way possible. This is another metric that’s easy to plug into the formula: Productivity = number of new customers ÷ amount of money spent to acquire those customers.

      For example, if you run any kind of advertising campaign, you can compare results and base your future spending accordingly.

      Let’s say that your total advertising budget is $3,000. You put $2,000 into television ads, $700 into radio ads, and $300 into print ads. When you track the results, you find that your television ad produced 50 new customers, your radio ad produced 15 new customers, and your print ad produced 9 new customers.

      Let’s plug those numbers into our equation. Television produced 50 new customers at a cost of $2,000 (50 ÷ 2000 = .025, or a productivity rate of 2.5%). The radio ads produced 15 new customers and cost $700 (15 ÷ 700 = .022, or a 2.2% productivity rate). Print ads brought in 9 new customers and cost $300 (9 ÷ 300 = .03, or a 3% return on productivity).

      From this analysis, it is clear that you would be getting the biggest bang for your advertising dollar using print ads.

      12. Utilize Peer Feedback

      This is especially useful when people who work in teams or groups. While self-assessments can be very useful, the average person is notoriously bad at assessing their own abilities.

      Advertising

      Just ask a room full of people how many consider themselves to be an above average driver and you’ll see 70% of the hands go up[2]! Now we clearly know that in reality about 25% of drivers are below average, 25% are above average, and 50% are average.

      Are all these people lying? No, they just don’t have an accurate assessment of their own abilities.

      It’s the same in the workplace. Using peer feedback will often provide a more accurate assessment of a person’s ability than a self-assessment would.

      13. Encourage Innovation and Don’t Penalize Failure

      When it comes to productivity, encouraging employee input and adopting their ideas can be a great way to boost productivity. Just make sure that any changes you adopt translate into higher productivity.

      Let’s say that someone comes to you requesting an entertainment budget so that they can take potential customers golfing or out to dinner. By utilizing simple productivity metrics, you can easily produce a cost benefit analysis and either expand the program to the rest of the sales team, or terminate it completely.

      Either way, you have gained valuable knowledge and boosted morale by including employees in the decision-making process.

      14. Use an External Evaluator

      Using an external evaluator is the pinnacle of objective evaluations. Firms that provide professional evaluations use highly trained personnel that even specialize in specific industries.

      They will design a complete analysis of your business’ productivity level. In their final report, they will offer suggestions and recommendations on how to improve productivity.

      While the benefits of a professional evaluation are many, their costs make them prohibitive for most businesses.

      Final Thoughts

      These are just a few of the things you can do when learning how to measure productivity. Some may work for your particular situation, and some may not.

      The most important thing to remember when deciding how to track productivity is to choose a method consistent with your goals. Once you’ve decided on that, it’s just a matter of continuously monitoring your progress, making minor adjustments, and analyzing the results of those adjustments.

      The business world is changing fast, and having the right tools to track and monitor your productivity can give you the edge over your competition.

      More Productivity Tips

      Featured photo credit: William Iven via unsplash.com

      Reference

      Read Next