Markdown Demo#
Note
This is a demo of the markdown syntax used in this documentation. It is not part of the site.
my_file.py | |
---|---|
- This is a comment in the code block.
Subheading#
Markdown is a lightweight markup language with plain-text-formatting syntax. Its design allows it to be converted to many output formats, but the original tool by the same name only supports HTML. Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.
Lorem Ipsum#
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Tables#
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
Method | Description |
---|---|
GET | Fetch resource |
PUT | Update resource |
DELETE | Delete resource |
Lists#
Unordered#
- Item 1
- Item 2
- Item 2a
- Item 2b
Ordered#
- Item 1
- Item 2
- Item 3
- Item 3a
- Item 3b
Tabs#
Images#
Links#
http://github.com - automatic! GitHub
Blockquotes#
As Kanye West said:
We're living the future so the present is our past.
Inline code#
Run the command: pip install my_package
Task Lists#
- @mentions, #refs, links, formatting, and
tagssupported - list syntax required (any unordered or ordered list supported)
- this is a complete item
- this is an incomplete item
Emoji#
@octocat This PR looks great - it's ready to merge!
Definition Lists#
- term
- definition
- term2
- definition2
Strikethrough#
The world is flat
Heading IDs#
My Great Heading#
Line Breaks#
Here's a line for us to start with.
This line is separated from the one above by two newlines, so it will be a separate paragraph.
This line is also a separate paragraph, but... This line is only separated by a single newline, so it's a separate line in the same paragraph.
Admonitions#
Note
This is a note
Tip
This is a tip
Bug
This is a bug
Quote
This is a quote
Abstract
This is an abstract
Warning
This is a warning
Danger
This is a danger
Success
This is a success
Question
This is a question
Failure
This is a failure
Info
This is a info
This has a custom title
This is a note
This one has no title
Click to expand
???
makes for collapsible content
see docs on Custom Admonitions for customizing the icon
Inline Admonitions#
(must be declared prior to the block they are next to)
Lorem ipsum
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa.
!!! info inline end "Lorem ipsum"
Lorem ipsum dolor sit amet, consectetur
adipiscing elit. Nulla et euismod nulla.
Curabitur feugiat, tortor non consequat
finibus, justo purus auctor massa, nec
semper lorem quam in massa.
Keyboard keys#
Ctrl+Cmd+F
Buttons#
with icons