0

What it looks like on MarkdownPad2 software: MarkdownPad screenshot

What it looks like on GitHub: GitHub screenshot

1
  • Welcome to Stack Overflow. Please see here for tips on how to improve your question to make it a bit clearer. Mar 21, 2017 at 12:41

2 Answers 2

0

There are numerous markdown engines and implementations, of which GitHub Flavored Markdown and MarkdownPad are just two. While they all implement markdown with basic similarities, there are always differences.

From looking at your screenshots, it seems the main issues lie with headings and code formatting.

  • For headings, try adding a space after the hash symbol:

    # Foo
    

    not

    #Foo
    
  • For code blocks, try wrapping the code with three backticks:

    ```
    Foo
    ```
    

In short, your best option is to read the GitHub markdown documentation and adjust your markdown text to fit with GitHub's formatting and syntax style.

0
0

You have multiple errors or not following some best practices:

  1. Headings should have one space between # and the Heading text, e.g. # Heading
  2. You should have empty line between paragraphs.
  3. For code blocks, wrapping with triple back-ticks
  4. Better to have only one top level header
  5. Better to put empty lines around heading line to make your file easy to read.

You should get familiar with the Github Flavored Markdown (GFM) first. Suggest to read these links first Mastering Markdown and Markdown Cheatsheet

2
  • No need to put empty lines before or after the heading line; the # is all that's required. Mar 23, 2017 at 21:19
  • Thanks @CodeMacabre. Yes you're right. My editor complains me if I don't put empty lines there. I've a Markdown Linter configured.
    – ray_g
    Mar 24, 2017 at 2:03

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.