MarkDown:基础知识

Posted 2020-12-26 mfcfine

MarkDown:基础知识

• 段落、标题、区块代码
• 斜体和粗体
• 列表
• 超链接
• 图片
• 代码

获取Markdown格式语法的要点

这页提供了 markdown 简单的概述给想使用的人，语法说明 页提供了完整详细的文件，说明每项功能，但是Markdown其实很简单就可以上手，这页文件提供了一些范例，并且每个范例都有提供输出的html结果。

其实直接试试看也是一个很不错的方法，Dingus是一个网页应用程序，让你可以把你的Markdown文件转成XHTML。

Note: 这份文件本身也是用markdown写到，你也可以看看它的原始文件

段落、标题、区块代码

一个Enter(回车)代表空格，
两个Enter(回车)代表分段

一个段落实由一个以上的连接的行句组成，而一个以上的空行则会切分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和tab，那该行也会被视为空行），一般的段落不需要用空白或断行缩排。

markdown支持两种标题语法，[Setext][1]和[atx][2]形式，Setext形式使用底线的形式，利用=(最高阶标题)和-(第二阶标题)，Atx形式在行首插入1到6个#（井号），对应到标题1到6阶。

区块引用则使用email形式的‘>‘(角括号、大于号)表示。

Markdown语句:

A First Level Header(一级标题)
====================

A Second Level Header(二级标题)
---------------------

我思故
我在
--笛卡尔

### Header 3(三级标题)

> 这是一个引用
> 
> 这是引用的第二段
>
> ## 这是引用中的二级标题

输出的HTML语句：

<h1>A First Level Header(一级标题)</h1>

<h2>A Second Level Header(二级标题)</h2>

<p>我思故
我在
--笛卡尔</p>
    
<h3>Header 3(三级标题)</h3>

<blockquote>
    <p>这是一个引用</p>
    
    <p>这是引用的第二段</p>
    
    <h2>这是引用中的二级标题</h2>
</blockquote>

斜体和粗体

Markdown使用*(星号)和_(底线)来标记需要强调的文本。

Markdown:

部分文字为*斜体*
同样有部分文字为_斜体_

使用两个星号代表**强调**
或者，如果您愿意，__使用两个下划线代替__

输出的HTML语句：

<p>部分文字为<em>斜体</em>
同样有部分文字为<em>斜体</em></p>

<p>使用两个星号代表<strong>强调</strong>
或者，如果您愿意，<strong>使用两个下划线代替</strong></p>

列表

无序列表使用*(星号)、+(加号)和-(减号)来作为列表的项目标记，这些符号都是可以使用的。

使用*(星号)：

*   糖果
*   口香糖
*   酒

使用+(加号)：

+   糖果
+   口香糖
+   酒

使用-(减号)：

-   糖果
-   口香糖
-   酒

都会输出：

<ul>
<li>糖果</li>
<li>口香糖</li>
<li>酒</li>
</ul>

有序列表则使用一般的数字和英文句号作为项目标记：

1. 红色
2. 绿色
3. 蓝色

输出：

<ol>
<li>红色</li>
<li>绿色</li>
<li>蓝色</li>
</ol>

如果你在项目之间插入空行，那么项目的内容会用<p>标签包起来，你也可以在一个项目内放上多个段落，只要在它前面缩进4个空格或1个tab。

*   列表项。

    有多个段落。

*   列表中的另一项。

输出：

<ul>
<li>
    <p>列表项。</p>
    <p>有多个段落。</p>
</li>
<li>
    <p>列表中的另一项。</p>
</li>
</ul>

超链接

Markdown支持两种形式的插连接语法： 行内 和 参考 两种形式，两种都是使用[]方括号来把文字转成超链接。

行内形式是直接在[]方括号和面附上链接地址：

这是一个[示例链接](http://example.com/)。

输出：

<p>这是一个<a href="http://example.com/">示例链接</a>。</p>

你也可以选择性的加上 title 属性：

这是一个[示例链接](http://example.com/ "标题")。

输出：

<p>这是一个<a href="http://example.com/" title="标题">示例链接</a>。</p>

参考形式的超链接让你可以为超链接定义一个名称，之后你可以在文件的其他地方定义该超链接的内容：

访问[百度][1]，[腾讯][2]，[阿里巴巴][3]。

[1]: https://www.baidu.com/ "百度"
[2]: https://www.tencent.com/zh-cn/index.html "腾讯"
[3]: http://www.alibaba.com/ "阿里巴巴"

输出：

<p>访问
<a href="https://www.baidu.com/" title="百度">百度</a>，
<a href="https://www.tencent.com/zh-cn/index.html" title="腾讯">腾讯</a>，
<a href="http://www.alibaba.com/" title="阿里巴巴">阿里巴巴</a>。
</p>

title 属性是选择性的，连接名称可以用字母、数字和空格，但是不分大小写：

访问[腾讯首页][QQ]

[qq]: http://www.qq.com/ "腾讯网"

输出：

<p>访问<a href="http://www.qq.com/" title="腾讯网">腾讯首页</a></p>

图片

图片的语法和超链接很像。

行内行式（title 是选择性的）：

![MD](https://i.imgur.com/hRqgd0o.jpg "Markdown")

參考形式：

![MD][id]

[id]: https://i.imgur.com/hRqgd0o.jpg "Markdown"

上面兩種方法都會輸出：

<p>
<img src="https://i.imgur.com/hRqgd0o.jpg" alt="MD" title="Markdown" />
</p>

代码

在一般的段落文字中，你可以使用反引号` 来标记程序码区段，区段内的&、<和>都会被自动装换成HTML实体&、&lt、>，这项特性让你可以很容易的在程序区段内插入HTML码：

我强烈建议不要使用任何`<blink>`标签&。

输出：

<p>我强烈建议不要使用任何<code>&lt;blink&gt;</code>标签&amp;。</p>

如果要建立一个已经格式化好的程序码区块，只要每行都缩进4个空格或是一个tab就可以了，而&、<和>也一样会自动装成HTML实体。

Markdown:

如果您希望您的页面在XHTML 1.0 Strict下验证，
你必须在你的blockquotes中放置段落标记：

    <blockquote>
        <p>例子</p>
    <blockquote>

输出：

<p>
如果您希望您的页面在XHTML 1.0 Strict下验证，
你必须在你的blockquotes中放置段落标记：
</p>

<pre>
<code>&lt;blockquote&gt;
    &lt;p&gt;例子&lt;/p&gt;
&lt;blockquote&gt;
</code>
</pre>