mirror of
https://github.com/imfing/hextra.git
synced 2025-10-31 10:14:52 -04:00
83f3b5052e
* chore(docs): rename `exampleSite` to `docs` and create `examples` * chore(build): update build script to support new version format and source directories; add v0.10 to documentation menu
158 lines
2.3 KiB
Markdown
158 lines
2.3 KiB
Markdown
---
|
|
title: Markdown Syntax Guide
|
|
date: 2020-01-01
|
|
authors:
|
|
- name: imfing
|
|
link: https://github.com/imfing
|
|
image: https://github.com/imfing.png
|
|
- name: Octocat
|
|
link: https://github.com/octocat
|
|
image: https://github.com/octocat.png
|
|
tags:
|
|
- Markdown
|
|
- Example
|
|
- Guide
|
|
excludeSearch: true
|
|
---
|
|
|
|
This article offers a sample of basic Markdown syntax that can be used in Hugo content files.
|
|
<!--more-->
|
|
|
|
## Basic Syntax
|
|
|
|
### Headings
|
|
|
|
```
|
|
# Heading 1
|
|
## Heading 2
|
|
### Heading 3
|
|
#### Heading 4
|
|
##### Heading 5
|
|
###### Heading 6
|
|
```
|
|
|
|
## Heading 2
|
|
### Heading 3
|
|
#### Heading 4
|
|
##### Heading 5
|
|
###### Heading 6
|
|
|
|
### Emphasis
|
|
|
|
```text
|
|
*This text will be italic*
|
|
_This will also be italic_
|
|
|
|
**This text will be bold**
|
|
__This will also be bold__
|
|
|
|
_You **can** combine them_
|
|
```
|
|
|
|
*This text will be italic*
|
|
|
|
_This will also be italic_
|
|
|
|
**This text will be bold**
|
|
|
|
__This will also be bold__
|
|
|
|
_You **can** combine them_
|
|
|
|
### Lists
|
|
|
|
#### Unordered
|
|
|
|
```
|
|
* Item 1
|
|
* Item 2
|
|
* Item 2a
|
|
* Item 2b
|
|
```
|
|
|
|
* Item 1
|
|
* Item 2
|
|
* Item 2a
|
|
* Item 2b
|
|
|
|
#### Ordered
|
|
|
|
```
|
|
1. Item 1
|
|
2. Item 2
|
|
3. Item 3
|
|
1. Item 3a
|
|
2. Item 3b
|
|
```
|
|
|
|
### Images
|
|
|
|
```markdown
|
|
|
|
```
|
|
|
|
|
|
|
|
### Links
|
|
|
|
```markdown
|
|
[Hugo](https://gohugo.io)
|
|
```
|
|
|
|
[Hugo](https://gohugo.io)
|
|
|
|
### Blockquotes
|
|
|
|
```markdown
|
|
As Newton said:
|
|
|
|
> If I have seen further it is by standing on the shoulders of Giants.
|
|
```
|
|
|
|
> If I have seen further it is by standing on the shoulders of Giants.
|
|
|
|
### Inline Code
|
|
|
|
```markdown
|
|
Inline `code` has `back-ticks around` it.
|
|
```
|
|
|
|
Inline `code` has `back-ticks around` it.
|
|
|
|
### Code Blocks
|
|
|
|
#### Syntax Highlighting
|
|
|
|
````markdown
|
|
```go
|
|
func main() {
|
|
fmt.Println("Hello World")
|
|
}
|
|
```
|
|
````
|
|
|
|
```go
|
|
func main() {
|
|
fmt.Println("Hello World")
|
|
}
|
|
```
|
|
|
|
### Tables
|
|
|
|
```markdown
|
|
| Syntax | Description |
|
|
| --------- | ----------- |
|
|
| Header | Title |
|
|
| Paragraph | Text |
|
|
```
|
|
|
|
| Syntax | Description |
|
|
| --------- | ----------- |
|
|
| Header | Title |
|
|
| Paragraph | Text |
|
|
|
|
## References
|
|
|
|
- [Markdown Syntax](https://www.markdownguide.org/basic-syntax/)
|
|
- [Hugo Markdown](https://gohugo.io/content-management/formats/#markdown)
|