Markdown 入门指南

Markdown基本语法入门指南

Markdown的目标是实现【易读易写】。它兼容HTML ,它的语法目标是:成为一种适用于网络的书写语言。

特殊字符自动转换

在HTML文件中,有两个字符需要特殊处理:< 和 &。<符号用于起始标签,&符号则用于标记HTML实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是&lt+;和&amp+;。


标题

Markdown支持两种标题的语法,类 Setext 和 atx形式。

其中Setext是用 底线来做标记的 利用=(最高阶标题)和-(第二阶标题),

例如

This  is an  H1
===============

This is an H1

This is an H2
--------------

This is an H2

Ps:任何数量的= 和-都可以有效果

类Atx 是在行首插入 1 到 6 个#,对应到标题1 到 6阶,

例如

# 这是 H1

## 这是 H2

###### 这是H6

这是 H1

这是 H2

这是H6

区块引用Blockquotes :

引用的区块内也可以使用其他的Markdown语法,包括标题、列表、代码区块等:
>##这是一个标题
>
>1.  这是第一行列表项。
>2. 这是第二行列表项。
>
>给出一些例子代码:
>
>  return shell_exec("echo $input | $markdown_script");

这是一个标题

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");


列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

*  Red
*  Green
*  Blue

+  Red
+  Green
+  Blue

-  Red
-  Green
-  Blue
  • Red
  • Green
  • Blue
有序列表 使用数字接着一个英文句点:
1. Bird
2. Math
3. Yellow
很重要的一点是,你在列表标记上使用的数字并不会影响输出的HTML结果,上面的列表所产生的HTML 标记为:
<ol>
<li>Bird</li>
<li>Math</li>
<li>Yellow</li>
</ol>
即使你写成
1. Bird
1. Math
1.Yellow
也不影响HTML的输出
  1. Bird
  2. Math
  3. Yellow
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Markdown 语法手册 概述宗旨兼容HTML特殊字符子自动转换 区块元素段落和换行标题区块引用列表代码区块列表...
    Junting阅读 539评论 0 0
  • 原作者:http://www.jianshu.com/p/1e402922ee32/ 导语: Markdown 是...
    代码移动工程师阅读 1,029评论 0 3
  • 导语 MarkDown是一种轻量级的[标记语言],它的有点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到...
    N_Nsd阅读 1,306评论 1 3
  • 转载文章,重新排版,仅用于个人查阅和学习目的。 原文地址:http://www.jianshu.com/p/1e4...
    Jayden_Cao阅读 214评论 0 2
  • 春宵将近月黄昏 柳吐新绿江水清 鱼戏浅滩人皆笑 独立橘州夜朦胧 问君忆君君知否 试看笔下染墨香 又道梦寒倚高楼 却...
    沧海一粟贝阅读 132评论 2 5