markdown语法使用图文教程

举报
炒香菇的书呆子 发表于 2021/04/21 23:49:37 2021/04/21
【摘要】 markdown语法使用图文教程

Markdown是什么

Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。
Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

Overview

它由Aaron Swartz和John Gruber共同设计,Aaron Swartz于2013年1月11日自杀,有着开挂一般人生经历的程序员。维基百科对他的介绍是:软件工程师作家政治组织者互联网活动家维基百科人
他有着足以让你跪拜的人生经历:

  • 14岁参与RSS 1.0规格标准的制订。
  • 2004年入读斯坦福,之后退学。
  • 2005年创建Infogami,之后与Reddit合并成为其合伙人。
  • 2010年创立求进会(Demand Progress),积极参与禁止网络盗版法案(SOPA)活动, 最终该提案被撤回。
  • 2011年7月19日,因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
  • 2013年1月自杀身亡。
    在这里插入图片描述

基本构成

分段和换行

段落就是一个或多个连续的文本行。在markdown源代码中,段落由两个或多个空行分隔。你只需要一个空行(按“Enter”一次)来创建一个新的段落。

标题

在标题名称前面输入#号,可以创建标题
标题使用 1-6 级 (#) ,例如:

>
># 这是标题1
>##  这是标题2
>### 这是标题3
>####  这是标题4
>#####  这是标题5
>######  这是标题6

在这里插入图片描述

引用

Markdown使用电子邮件风格的>字符进行块引号。它们表现为:

> This is a blockquote with two paragraphs. This is first paragraph.
> This is second pragraph. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.

在这里插入图片描述

在引号内容后面输入’ > '将生成一个引号块

列表

输入 * list item 1 will create an unordered list - the * symbol can be replace with + or -.

Input 1. list item 1 will create an ordered list - their markdown source code is as follows:

## un-ordered list
*   Red
*   Green
*   Blue

## ordered list
1.  Red
2. 	Green
3.	Blue

在这里插入图片描述

任务列表

任务列表是标记为 - [ ] 或 -[x] (不完整或已完成)的列表。例如:

- [ ] incomplete
- [x] completed

在这里插入图片描述

您可以通过单击项目前的复选框来更改完整/不完整状态。

代码高亮

输入 ``` ,在 ``` 后面添加语言名称:

样例:
```c
#inlcude<stdio.h>
int main()
{

    printf("getup");
}

在这里插入图片描述

数学公式

您可以使用MathJax渲染LaTeX数学表达式。

要添加一个数学表达式,输入’ $$ '。这将触发一个接受Tex/LaTex源的输入字段。例如:

V 1 × V 2 = i j k X u Y u 0 X v Y v 0 \mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix}

In the markdown source file, the math block is a LaTeX expression wrapped by a pair of ‘$$’ marks:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

在这里插入图片描述

获取更多关于latex的信息 点击此处.

表格

输入 |一级标题 | 二级标题 | 创建表格

创建表之后,将焦点放在该表上将打开该表的工具栏,您可以在其中调整该表的大小、对齐或删除该表。您还可以使用上下文菜单复制和添加/删除单独的列/行。

In markdown source code, they look like:

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

在这里插入图片描述

还可以在表中包括链接、粗体、斜体或删除线等内联标记。

最后,通过在标题行中包含冒号(’:’),你可以定义该列中的文本为左对齐、右对齐或居中对齐:

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |

在这里插入图片描述
最左边的冒号表示左对齐的列;最右边的冒号表示右对齐的列;两边的冒号表示列居中。

脚注

你可以在这里创建一个脚注[^footnote].

[^footnote]: 这段话自动生成 **footnote**.

在这里插入图片描述

划线

在空行中输入’ *** ‘或’——‘并按下’ return '将绘制一条水平线。


在这里插入图片描述

前页眉

在文章顶部输入---,生成页眉

目录 (TOC)

输入@[toc]。这将创建一个“目录”部分。TOC从文档中提取所有的标题,当您向文档添加内容时,它的内容会自动更新。

行内元素

Span元素将在输入后立即解析和呈现。将光标移动到这些span元素的中间将把这些元素扩展为markdown源。下面是对每个span元素的语法解释。

链接

Markdown支持两种样式的链接:内联链接和引用链接。
在这两种样式中,链接文本都由[方括号]分隔。
要创建内联链接,请在链接文本的右方括号后紧接一组常规圆括号。在括号内,将URL放在你想要链接指向的地方,以及一个可选的链接标题,用引号括起来。例如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

在这里插入图片描述

这是 样例 超链接

[链接](https://blog.csdn.net/qq_43475285) 没有文本.

网络连接

Yo你可以设置href为头文件**,这将创建一个书签,允许你在点击后跳转到该区域。例如:

Ctrl + Click This link 将会跳转到Block Elements.

文献链接

引用样式的链接使用第二组方括号,你可以在其中放置一个你选择的标签来识别链接:

这是一个 [样例][id] .

点击这里会跳转到下面写的网址中

[id]: https://blog.csdn.net/qq_43475285  "网站内容"

在这里插入图片描述

图片

图片和链接有相似的语法,但是它们需要额外的’ !’ char在链接开始前。插入图像的语法如下所示:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

在这里插入图片描述

强调

Markdown treats asterisks (*) and underscores (_) as indicators of emphasis. Text wrapped with one * or _ will be wrapped with an HTML <em> tag. E.g:
Markdown把星号(“*”)和下划线(“_”)当作强调的标志。用’ * ‘或’ _ '包装的文本将被HTML<em>标签包装。例句:

*强调*

_强调_

在这里插入图片描述

加粗

A double * or _ will cause its enclosed contents to be wrapped with an HTML <strong> tag, e.g:

**加粗**

__加粗__

output:

加粗

加粗

删除线

GFM添加了创建删除线文本的语法,这在标准的Markdown中是缺失的。

~~删除.~~ becomes 删除.
在这里插入图片描述

下划线

<u>下划线</u> 变成 下划线.
在这里插入图片描述

Emoji 表情:smile:

:smile:

:smile:

高亮

使用’ == '来换行突出显示内容。例如:“= =高亮= =”。

==高亮==

HTML

您可以使用HTML来样式化纯Markdown不支持的内容。例如,使用<span style="color:red">this text is red</span>来添加带有红色的文本。

在这里插入图片描述

视频

你可以使用 <video> 标签.例如:

<video src="xxx.mp4" />

参考文档:https://github.com/younghz/Markdown

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。