markdown基础语法
markdown基础语法
1.标题
标题格式:#+空格+标题内容,如# 标题
2.段落
用空白行创建段落,例如:
对泉能自诫,如镜静相邻。
最佳实践:
不要用空格或制表符(tabs)缩进段落。用 和全角空格缩进。
3.换行
两种方式,一种是在结尾处输入多个空格(>=2),然后按回车换行;另一种方式是用html标签</br>实现换行。
4.强调
两种强调,一种是加粗,一种是斜体。
1)加粗
语法 **加粗内容** 或 __加粗内容__ ,即用两个星号或两个下划线将强调内容包起来。建议用两个星号(**),不建议用两个下划线(__)
2) 斜体
一个或一个_。
如果想 加粗且斜体,用三个*号包起来(号前面要有一个空格)。
This is really very important text.
5.引用
如果要引用,在段落前加一个>符号。
这句话我没说! --鲁迅
要结束引用,需要另起一段(加一个空行)。
可以包含多个段落。在段落的空白行添加一个>符号。
这句话我没说! --鲁迅
我说过。 --罗翔
引用可以嵌套。在要嵌套的段落 前添加一个>>符号。
罗翔老师说过:
啤酒饮料矿泉水,瓜子香烟大碗茶。 --罗翔
块元素可以包含一部分其他markdown格式的元素,如**,###等。
6.列表
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
注意:
1. 数字或-后要有一个空格,不然不识别
2. 创建子列表用四个空格
2. 列表最好另起一段(即用空行隔开)
- 标题
- 子列表1
- 子列表2
- 段落
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
- 列表1
- 列表2
- 子列表1
- 子列表2
- 列表3
- 列表4
在列表中嵌套其他元素:
-
嵌套段落
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。 -
嵌套引用块
罗翔老师说过
-
嵌套代码块
代码块通常用四个空格或一个制表符缩进。当它们被放在列表中时,请将它们缩进8个空格或2个制表符。
Test
-
嵌套图片
-
嵌套列表
- abc
- cde
7.代码
反引号
要将单词或短语表示为代码,请将其包裹在反引号(`)中。
注意:如果包裹的内容开始时有一个空格,对称的结束时也要有一个空格。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
At the command promtp,type `nano` . |
At the command promtp,type<code>nano</code>. |
At the command promtp,type nano. |
转义反引号
如果代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在反双引号( ``)中。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
``Use `code` in your Markdown file.`` |
<code> Use `code` in your Markdown file.</code> |
Use `code ` in your Markdown file. |
代码块
要创建代码块,2种方法:
-
将代码块的每一行缩进至少四个空格或一个制表符。
test</tile><br> </head><br> </html></p> </li> <li> <p>如果不用缩进的代码块,请使用<code>围栏式代码块</code>。<br> <code>围栏代码块是用三个反引号(```)或三个波浪符号(~~~)。</code><br> 围栏代码块可以指定代码的类型(在第一个```后+空格+代码类型),如下代码类型指定为html:</p> <pre><code class="language-html"> <html> <head> <title>test</tile> </head> </html> </code></pre> </li> </ol> <h2 id="8分隔线">8.分隔线</h2> <p>要创建分隔线,在<strong>单独一行</strong>上使用至少三个星号(***)或至少三个破折号(---)或至少三个下划线(___),并且不能包含其他内容。</p> <pre><code class="language-text">*** --- —————— </code></pre> <pre><code class="language-text">最佳实践: 为了兼容性,请在分隔线的前后均添加空白行。 ---- </code></pre> <h2 id="9链接">9.链接</h2> <p>示例如下:</p> <p><code>这是一个链接 **[Markdown语法](https://markdown.com.cn "最好的markdown教程")**。</code></p> <p>效果:<br> 这是一个链接 <a href="https://markdown.com.cn" title="最好的markdown教程" target="_blank">Markdown语法</a>。<br> 其中,</p> <ol> <li>方括号中是链接描述,圆括号中是链接url和链接title。</li> <li><code>最好的markdown教程</code>是可选的title,用于显示鼠标悬浮在链接上浮动框中的文字。</li> <li>可以给链接加格式,如加粗、斜体、可以把方括号中的链接描述设置为显示为代码等。</li> </ol> <p>使用尖括号可以方便的把URL或者email地址变成可点击的链接:</p> <pre><code class="language-text"><https://markdown.com.cn> <fake@example.com> </code></pre> <p>效果如下:<br> <a href="https://markdown.com.cn" target="_blank">https://markdown.com.cn</a><br> <a href="mailto:fake@example.com" target="_blank">fake@example.com</a></p> <p><strong>引用类型链接(锚点)</strong><br> 引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。</p> <p><strong>例一</strong></p> <pre><code class="language-html">语法:[描述](#id) 例子: <h3 id=_link_click_group>触发点 </h3> [点击跳到链接一](#_link_1st)、[点击跳到链接二](#_link_2nd)、[点击跳到链接三](#_link_3rd)、脚注[^1] <a id=_link_1st>链接一</a>([回到触发点](#_link_click_group)) <a id=_link_2nd>链接二</a>([回到触发点](#_link_click_group)) <span id=_link_3rd>链接三</span>([回到触发点](#_link_click_group)) [1]: 我是注脚 </code></pre> <p>效果:</p> <h3 id=_link_click_group>触发点</h3> <p><a href="#_link_1st">点击跳到链接一</a>、<a href="#_link_2nd">点击跳到链接二</a>、<a href="#_link_3rd">点击跳到链接三</a>、<br> 生成一个脚注1<sup class="footnote-ref"><a href="#fn1" id="fnref1">[1]</a></sup><br> <a id=_link_1st>链接一</a>(<a href="#_link_click_group">回到触发点</a>)<br> <a id=_link_2nd>链接二</a>(<a href="#_link_click_group">回到触发点</a>)<br> <span id=_link_3rd>链接三</span>(<a href="#_link_click_group">回到触发点</a>)</p> <p><strong>例二</strong><br> 作为变量。变量的值不会显示在页面上。</p> <pre><code class="language-md">这个链接用 3 作为网址变量 [Google][3] 这个链接用 runoob 作为网址变量 [Runoob][runoob] 然后在文档的结尾为变量赋值(网址) [3]: http://www.google.com/ [runoob]: http://www.runoob.com/ </code></pre> <p>效果:<br> 这个链接用 3 作为网址变量 <a href="https://www.baidu.com/" target="_blank">Baidu</a><br> 这个链接用 runoob 作为网址变量 <a href="http://www.runoob.com/" target="_blank">Runoob</a><br> 然后在文档的结尾为变量赋值(网址)</p> <h2 id="10图片">10.图片</h2> <p>要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。</p> <p>插入图片Markdown语法代码:<code></code>。</p> <p>对应的HTML代码:<code><img src="图片链接" alt="图片alt" title="图片title"></code></p> <h2 id="11转义字符">11.转义字符</h2> <p>要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符<code>\</code>。</p> <p><code>\* Without the backslash, this would be a bullet in an unordered list.</code></p> <p>渲染效果如下:<br> * Without the backslash, this would be a bullet in an unordered list.</p> <h2 id="12内嵌html标签">12.内嵌HTML标签</h2> <p>对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。如需使用 HTML,不需要额外标注这是 HTML 或是 Markdown,只需 HTML 标签添加到 Markdown 文本中即可。</p> <pre><code class="language-text">HTML 用法最佳实践: 出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问,请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。 对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>,请在其前后使用空行(blank lines)与其它内容进行分隔。尽量不要使用制表符(tabs)或空格(spaces)对 HTML 标签做缩进,否则将影响格式。 在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。 </code></pre> <hr class="footnotes-sep"> <section class="footnotes"> <ol class="footnotes-list"> <li id="fn1" class="footnote-item"><p>这是脚注的内容 <a href="#fnref1" class="footnote-backref">↩︎</a></p> </li> </ol> </section>
浙公网安备 33010602011771号