Advanced Formatting in GitHub Markdown

Sưu tập từ:

https://gist.github.com/apaskulin/1ad686e42c7165cb9c22f9fe1e389558#your-anchor-name

GitHub Flavored Markdown lets you create useful documents in GitHub and GitHub Enterprise using .md files. Like other varieties of markdown, GitHub Markdown tries to be as readable as possible in its raw form, resulting in an intentionally limited set of formatting options. However, these options can feel restrictive when dealing with complex content.

Although GitHub Markdown strips out most HTML tags, here are a few tricks that can give you more flexibility when formatting your documents. These advanced formatting options can make your documents more useable, but they come at the expense of plain text readability, so use with caution.

Check out this excellent cheatsheet for an overview of standard formatting in GitHub Markdown.

• Images
• Dropdowns
• Buttons
• Anchor Links
• Horizontal line
• Extra space
• References

Images

To left align and resize an image:

Use:

<img align="left" width="200" src="https://apaskulin.github.io/waxtechnical/images/pup.jpg">

To right align and resize an image:

Use:

<img align="right" width="200" src="https://apaskulin.github.io/waxtechnical/images/pup.jpg">

To center and resize an image:

Use:

<p align="center">
  <img width="300" src="https://apaskulin.github.io/waxtechnical/images/pup.jpg">
</p>

Dropdowns

To create a dropdown containing text:

Use:

<details>
<summary>Example</summary>
This is a dropdown with text!
</details>

To create a dropdown containing a list:

Use:

<details>
<summary>Example</summary>
<ul><li>This dropdown contains</li>
<li>a list!</li></ul>
</details>

To create a dropdown containing an image:

Example

Use:

<details>
<summary>Example</summary>
<img src="https://apaskulin.github.io/waxtechnical/images/pup.jpg" width="500">
</details>

To create a dropdown containing code:

This dropdown contains
a code block!

Use:

<details>
<summary>Example</summary>
<pre>$ This dropdown contains<br>a code block!</pre>
</details>

Buttons

To create a single button:

Use:

|[Click here](https://github.com/)|
|---|

To create a row of buttons:

Use:

|[Click here](https://github.com/)|[Or here](https://github.com/)|[Or here](https://github.com/)|
|---|---|---|

Anchor links

To link to a heading:

This is an example of an anchor link to a heading.

Use:

This is an example of an [anchor link](#anchor-links) to a heading.

To create an anchor anywhere on the page, use:

<a name="your-anchor-name">

This is an example of an anchor link anywhere on the page.

Use:

See [creating an anchor link anywhere](#manual-anchor).

Horizontal line

To create a horizontal line:

Use:

---

Extra space

To add extra space, use one or more:

<br>

Make button

<kbd>Ctrl</kbd> + <kbd>C</kbd>

Ctrl + C

<p>To make George eat an apple, press <kbd><kbd>Shift</kbd>+<kbd>F3</kbd></kbd></p>

To make George eat an apple, press Shift+F3

View > Syntax > OpenGL Shading Language > GLSL

File | New

https://meta.stackexchange.com/questions/193531/what-is-the-markdown-for-menu-options

Chữ gạch ngang

~~this~~ this

Youtube

[![Everything Is AWESOME](http://i.imgur.com/Ot5DWAW.png)](https://youtu.be/StTqXEQ2l-Y?t=35s "Everything Is AWESOME")

https://stackoverflow.com/questions/11804820/how-can-i-embed-a-youtube-video-on-github-wiki-pages

SVG Embed (Nhúng SVG)

![soiqualang](http://dev.dothanhlong.org/tmp/t1.svg)

https://stackoverflow.com/questions/14951321/how-to-display-html-content-in-github-readme-md

<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
<foreignObject width="100" height="100">
    <div xmlns="http://www.w3.org/1999/xhtml">
        <ul>
            <li>text</li>
        </ul>
        <!-- Other embed HTML element/text into SVG -->
    </div>
</foreignObject>
</svg>

Random hình ảnh

![Soi's test](https://demo.vinagit.com/AgriVinaGIT/api/randimg/B%C3%B4ng%20v%E1%BA%A3i.jpg)

Shields

![Soi's test](https://img.shields.io/badge/soiqualang-website-red)

Custom shield

https://shields.io/

https://img.shields.io/badge/soiqualang-website-red

Top Languages Card

[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=soiqualang&langs_count=8)](https://github.com/soiqualang/Py4Sqlite3)

Compact Language Card Layout

[![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=soiqualang&langs_count=8&layout=compact)](https://github.com/soiqualang/Py4Sqlite3)

GitHub Extra Pins

[![ReadMe Card](https://github-readme-stats.vercel.app/api/pin/?username=soiqualang&repo=Vietnam_map_history)](https://github.com/soiqualang/Vietnam_map_history)

Showing icons

![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=soiqualang&show_icons=true)

Adding private contributions count to total commits count

![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=soiqualang&count_private=true)

References

https://gist.github.com/soiqualang/61bad7aa665290ef1bd034f240ee1b0d GitHub Flavored Markdown Spec - https://github.github.com/gfm/
Advanced Markdown with David Wells - https://github.com/DavidWells/advanced-markdown
Markdown Cheatsheet PDF - https://enterprise.github.com/downloads/en/markdown-cheatsheet.pdf