关于markdown需要澄清的误解:

首先, 最大的一个误解就是 转义! markdown不支持对小于号 < 的转义, 如 <"pre">, 这时候仍然会认为是一个pre标签的! 所以, 不能用\来消除html标签,只有 * 才会被\所转义.

Markdown中,以下字符支持使用反斜线转义:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 大括号
[] 中括号
() 小括号
# 井号
+ 加号
- 减号(连字符)
. 句点
! 感叹号

markdown 本身也支持 html标签.

对Markdown语法无法支持的格式,你可以直接用HTML。你不需要事先声明或者使用什么定界符来告诉

Markdown要写HTML了,你直接写就是了,如链接a, 图片img等.

markdown也要区分块级元素和行内元素

唯一的限制是那些块级HTML元素 -- 如 div,table, pre, p等等 -- 必须使用(至少1行)空行

与相邻内开, 并且块元素的开始和结束标签之前不要留有空格或TAB。

注意一点,不要在块级HTML元素内使用Markdown格式化命令,Markdown不会处理它们。比如你不要在一个

HTML块中使用 * emphasis * 这样的Markdown格式化命令. 但是, 不同于这些块级HTML元素,在HTML行内元素内的

Markdown语法标记会被正确处理



关于这一点的理解是: (下面的列表,即使第一个列表的数字写成10, 仍然会从1开始排列)

10. 是说markdown中, 本身是不需要(不是不能)你显式的去写 div p pre hr hx等等这些标签的, 只要你的写法正确, md会自动的为你生成这些标签的

20. 是说如果你用markdown写的东西, 对应翻译成html后, 是html中的块级元素 的时候, 你就要在这个内容的前后都要用空行进行分隔.

30. 比如说, 用三个/以上的 *** 可以生成水平线hr, 由于hr是html中的块级元素, 所以在markdown中, 这三个 *** 要用前后空行来分隔.就是这个意思,如果不这样前后分隔, md就不认为是 水平线, 还是照原样输出 三个星号.

引用块 (markdown中的名字 都叫"什么块")

方法1: 如果每一行你都使用硬换行并在行首(注意, 是行首!)放一个>符号,看上去会很美观

方法2: (如果觉得每行写一个>太累)Markdown允许你偷懒,你只需在 硬换行段落 的第一行之前放一个>号,

只需要多加一个>,就得到嵌套的引用块(即引用块中的引用块)

使用两个>, (注意中间有一个空格) > This is nested blockquote.可以得到嵌套的引用块.

引用块中可包含其它Markdown元素,如标题、列表和代码块

代码块 (不同于引用块)

我们经常在写有关编程或标记语言源代码时用到预格式化的代码块。不像格式化普通段落,代码块中的行会

按字面进行解释。Markdown对代码块同时使用pre 和 code标签包裹, 生成pre code...

在Markdown中要生成一个代码块,只需要在代码块内容的每一行缩进至少四个空格或者一个TAB。

Markdown不会解析代码块中的Markdown标记。如代码块中的星号就是星号,失去了它原来的Markdown含义

要注意代码块用tab或四个空格缩进时, 一定要前后用空行分隔

因为这是代码块, 是块元素, 所以,必须前后用空行分隔

这里注意, 如果下面的代码 前后没有空行, 则不会是代码块, 其中的超链接a和p/span/style都会被解释执行!!

这里注意, 如果下面的代码 前后没有空行, 则不会是代码块, 其中的超链接a和p/span/style都会被解释执行!!;
<a href="/index.php">跳转首页</a>
<p><span style="color: red">代码块, 前后没有空行分隔</span></p>
<font color="red">但是要注意, 虽然有缩进, 但是输出的内容不会有 缩进(因为是代码块)</font> 代码块前后用空行分隔, 则生成带灰色背景并且有边框的代码块
带灰色背景并且有边框的, 才是代码块.否则就不是代码块.

另外一种代码块的方法是: 用反引号, 一个或2个 或3个反引号

在实际应用中, 感觉用反引号, 来实现代码块, 更方便, 更直接, 更不会出错!

实际上, 不管是, 不管使用tab还是使用反引号 ```, 都要在代码块的前后 都要空出一个 空行.才能保证真的是生成代码块了.

反引号本身``` 跟里面的内容之间是否留有空行无关!

列表?

无序列表用星号, 加号, 减号 加一个空格

有序列表用数字加英文句点.

有一点需要注意,你在列表中输入的标记数字并不会反映到Markdown输出的HTML之中。默认的会输出ul>li

要点在于,如果你愿意,就在你的Markdown有序列表里顺序使用数字(这样源代码里的顺序和生成的顺序会一致),

如果你希望省点儿事,你就不用费心(去手工编号)

如果你打算偷懒,记住列表的第一行使用数字 1

要在列表项中使用引用,引用定界符 > 需要用tab缩进1次.

要在列表项中使用代码块,代码块需要缩进两次 -- 8个空格或者两个TAB

水平线

如果在一行里只放三个或更多个连字符,或星号或下划线,(注意没有等号!)你就会得到一个水平线标记hr

链接

这是一个链接

强调

一个* 是em强调, 两个* 才是strong. 三个* 是em和strong的综合效果, 即:加粗同时倾斜.


举例:

水平线:

(*** 和---没有前后空行分隔, 不能生成hr水平线?)




====

等号不能生成hr, 虽然前后都有空行分隔.

以下是引用块的例子

这是引用块

这是引用块, 每行都写 > 符号

这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块, 只在"硬回车" 段落的行首用 > 符号.

这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块这是引用块

这是嵌套引用块

这是嵌套引用块

以下是代码块的例子

    <?php
echo 'abc';
printf('your name is %s', $_POST['username']);
?>

以下是列表 中使用引用块和 代码块

  • 列表中使用引用块:

    列表中的引用块, 必须要用1个 tab缩进

    列表中的引用块, 必须要用1个 tab缩进

  • 列表中使用代码块

  • 列表中使用代码块

      <?php
    // 列表中使用代码块, 至少要两个tab缩进
    class IndexAction extends Action {
    function index() {
    echo "thinkphp...";
    }
    }
    ?>

关于markdown需要澄清的一些误解的更多相关文章

  1. Hekaton的神话与误解

    最近这段时间,我花了很多时间来更好的理解Hekaton——SQL Sever 2014里的全新内存表技术.我看了很多文章,了解了Haktaon的各种内部数据存储结构(主要是哈希索引和Bw-tree). ...

  2. 关于PHP的十大误解 你中了几个?

    作为开发人员,你常常会在网上看到不使用XX的理由之类的新闻.而作为最受欢迎的开源服务器端脚本语言,PHP也难逃这样的命运.殊不知,金无足赤.人无完人,再流行的语言都会存在缺点,或者是误解,因此,有些开 ...

  3. 批处理学习:for语句详解【经典】

    大纲 一 前言 二 for语句的基本用法 三 for /f (delims.tokens.skip.eol.userbackq.变量延迟) 四 for /r (递归遍历) 五 for /d (遍历目录 ...

  4. 批处理命令——for

    [1]for命令简介 先把for循环与for命令类比一下,这样学习理解快. for 循环语句,一般格式如下: for (表达式1;表达式2;表达式3) { 循环体; } 1. 表达式1 一般为初始状态 ...

  5. .NET 代码编译过程

    作为一种代码指令平台,Microsoft .NET比微软公司先前推出的其他技术平台要来得更为复杂.由于.NET提供了对多种编程语言以及(在理论上说)多重平台的支持,这就需要在传统的两个代 码层添加一个 ...

  6. bat命令之for命令详解

    ______________版主提醒____________________________ 为了避免影响技术讨论.提高看帖的舒适性,请大家不要在此帖下跟无实质内容的口水帖,特别是纯顶.纯支持.纯感谢 ...

  7. windows批处理学习(for和字符串)---03

    [1]for命令简介 先把for循环与for命令类比一下,这样学习理解快. for 循环语句,一般格式如下: 1 for (表达式1;表达式2;表达式3) 2 { 3 循环体; 4 } 1. 表达式1 ...

  8. 批处理学习:for语句详解

    大纲 一 前言 二 for语句的基本用法 三 for /f (delims.tokens.skip.eol.userbackq.变量延迟) 四 for /r (递归遍历) 五 for /d (遍历目录 ...

  9. GitChat·人工智能 | 除了深度学习,机器翻译还需要啥?

    本文开始要写作的时候,翻译圈里出了一个“爆炸性”的事件.6月27日下午,一个同传译员在朋友圈里爆料:某AI公司请这位译员去“扮演”机器同传,制造人工智能取代人工同传的“震撼”效果. 这个事件瞬间在译员 ...

随机推荐

  1. 深入了解Ant构建工具 命令

    深入了解Ant构建工具 标签: ant工具任务jarjavaclass 2010-05-29 21:16 1346人阅读 评论(2) 收藏 举报 版权声明:本文为博主原创文章,未经博主允许不得转载. ...

  2. 从0开始学java——JUnit4 复习,其实基本思想还是那些,不过采用了新的注释格式的语法

    看了深入探索 JUnit 4(http://www.ibm.com/developerworks/cn/education/java/j-junit4/index.html  ) 主要是讲了新的基于注 ...

  3. LeetCode:Single Number II

    题目地址:here 题目大意:一个整数数组中,只有一个数出现一次,其余数都出现3次,在O(n)时间,O(1)空间内找到这个出现一次的数 对于”只有一个数出现一次,其余数出现2次“的情况,很简单,只要把 ...

  4. 信息安全系统设计基础实验五 20135210&20135218

    北京电子科技学院(BESTI) 实     验    报     告 课程:信息安全系统设计基础           班级: 1352 姓名:程涵,姬梦馨             学号:2013521 ...

  5. php利用递归函数实现无限级分类

    相信很多学php的很多小伙伴都会尝试做一个网上商城作为提升自己技术的一种途径.各种对商品分类,商品名之类的操作应该是得心应手,那么就可以尝试下无限级分类列表的制作了. 什么是无限级分类? 无限级分类是 ...

  6. 《android基于andFix的热修复方案》实战篇

    有篇文章说的比较简洁,大家可以参考下:AndFix使用说明 下面说说实际使用中遇到的问题 1:如何继承到gradle项目中 dependencies { compile 'com.alipay.eul ...

  7. java网络编程基础

    前言 通过网络进行数据传输时,一般使用TCP/UDP进行数据传输.但是两个的区别就是TCP可靠,UDP不可靠.两个的共同之处就是都需要建立socket套接字,将IP地址和端口port进行绑定.但是服务 ...

  8. [设计模式] Javascript 之 外观模式

    外观模式说明 说明:外观模式是用于由于子系统或程序组成较复杂而提供的一个高层界面接口,使用客户端更容易访问底层的程序或系统接口; 外观模式是我们经常使用遇到的模式,我们经常涉及到的功能,可能需要涉及到 ...

  9. 转:java多线程--同步容器

    java同步容器 在Java的集合容器框架中,主要有四大类别:List.Set.Queue.Map.List.Set.Queue接口分别继承了Collection接口,Map本身是一个接口.注意Col ...

  10. Spring的辅助类

    http://www.cnblogs.com/maoan/p/3446224.html spring获取ApplicationContext对象的方法——ApplicationContextAware