MarkDown:基础知识

Posted mfcfine

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了MarkDown:基础知识相关的知识,希望对你有一定的参考价值。

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实体&amp;&lt&gt;,这项特性让你可以很容易的在程序区段内插入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>

以上是关于MarkDown:基础知识的主要内容,如果未能解决你的问题,请参考以下文章

markdown PHPExcel Notes和代码片段

markdown Git代码片段

markdown 岩组代码片段

markdown [magento] - 代码片段

markdown 在WordPress中使用jQuery代码片段

markdown 打字稿...编码说明,提示,作弊,指南,代码片段和教程文章