Fred's Blog

{“ERROR”:“GET FROM SOURCE FAILED: E405”} ,七牛导致AJAX评论失效解决办法

AJAX评论错误

前天使用了七牛加速，静态文件全部通过CDN加速，减轻服务器负担，但是今天突然发现评论无法提交了，错误提示“{“error”:“get from image source failed: E405”}”，网上搜索了一下，发现不少人也有此类问题。主要原因是七牛CDN缓存了ajax评论脚本 commonts-ajax.js（有的是function.js）文件，所以提交时导致评论失效了。

七牛CDN插件修改解决方案

打开七牛插件目录，找到wpjam-qiniutek.php文件打开，定位至100行return $html前，插入以下代码：

1

$html = str_replace('http://7xt1tb.com2.z0.glb.qiniucdn.com/wp-content/themes/Tinection-master/includes/js/function.js', 'http://www.xuzizi.cn/wp-content/themes/Tinection-master/includes/js/function.js', $html);

其原理是插件已经修改静态文件原目录至CDN目录，我只需要再把function.js（如果你的是comments-ajax.js就改为comments-ajax.js所在路径）这一个文件的目录改回来即可，其中第一个路径是CDN服务器上function.js的路径，需要把它替换为第二个路径，即网站原文件路径，具体路径请根据你自己的网站作修改。

修改comments-ajax.js

在主题文件夹下找到comments-ajax.js打开，并且找到如下代码：

1
2
3
4
5

var i = 0, got = -1, len = document.getElementsByTagName('script').length;
while ( i <= len && got == -1){
var js_url = document.getElementsByTagName('script')[i].src,
got = js_url.indexOf('comments-ajax.js'); i++ ;
}

它一般在最开头的位置，然后在这段代码之后再添加一句代码，如下：

1
2

// 修复七牛cdn评论失效
js_url = js_url.replace(‘qiniu.xuzizi.cn’,’www.xuzizi.cn');

修改好之后 保存即可。 最后，还要到七牛里面将原来缓存的comments-ajax.js文件删除，若wordpress有缓存插件的也要删除一遍缓存。 刷新文章页面，让七牛更新缓存文件。 更新完毕之后，即可恢复评论功能。

为什么你要写博客？ 陈素封

一个选择

我知道现在可能说这话有点不合时宜，毕竟博客时代都已经过去了，再号召大家用过就好像时的东西是不是有点逆流而上？ 我曾经也问过自己这个问题，但是我觉得，博客时代过去跟我们要开博客是没有多大关系的，就好像你的读书时代已经过去你就不再读书一样。 判断一件事情值不值得去做有一个方法：在一张白纸的左边写不值得做的原因，然后在右边写值得做的原因，写完一比较，一权衡，自然能够得出结果。 大家都成年人了，你会觉得这样思考分析总结的过程才是正确的思考的方法吧？ 所以，我在这里列出要写（独立）博客的原因，供大家去选择，然后填在你白纸的右边。 注意，我不是给你一个建议，而是提供一个选择，这个选择蕴藏着我也不知道的可能。

博客的内容

写博客不难，你可以当作是生活的记录，但是这样的记录没有任何的意义。写要对得住写本身，写出来的东西应该是思考的结果。我认为，如果你要开一个博客，博客的内容应该是这样的：

•  不是生活杂记、不是流水账、不是牢骚、不是抱怨、不是心情琐记……；
•  有目的地写，要务实，追求质量；
•  承认真实的自己，不要吹嘘，不要装逼，无需讨好读者；
•  记录自己学习、思考、总结的过程；
•  分享你的故事、所得、感想、经验；

值得写的原因

以下是一个清单，可以根据自己的情况匹配，然后选择。

重新认识自己

是不是很久没有跟自己对话了？ 你可以尝试从回答一些问题开始，将你过去要回避的问题写下来，例如就可以从这个九个问题开始：

• 请你介绍一下你自己，你是个什么样的人？
• 你有什么理想吗？这个理想是怎么形成的？
• 你理想的伴侣关系是什么样的？你自己在这个伴侣关系中扮演什么样的角色？要承担什么样的责任？
• 你理想的事业是什么，你正在做的工作符合你的事业理想吗？这份工作对你的意义是什么？
• 你对亲子关系怎么看？对你来说，什么是一个理想的父亲（母亲），你期望自己成为这样一个理想父亲（母亲）吗？
• 你对钱怎么看，你认为赚到多少钱是足够的？如果你明天一早醒来，已经有足够的钱，你将会如何继续安排自己的生活？
• 对你来说，什么是理想的性生活？什么是理想的性道德，在你的性道德观中，什么样的性生活是禁忌的，需要避免的，什么样的性生活是美好的，需要得到鼓励和发展的？
• 你的择友标准是什么？什么样的人你会愿意交往，什么样的人你会拒绝和他交往？
• 你对死亡怎么看？你希望自己活到多少岁，你准备怎么度过从现在到死亡的这段时间？如果你要立遗嘱，这份遗嘱会怎么写？

以上的这九个问题摘自《很少人能顺畅回答这9个问题——心理治疗刚开始医生常常会先问你的 》by 李孟潮。 这些问题的答案你可以选择不发，但是我强烈地建议写下来，只有在写的时候你才可以慎重地思考这些问题，而不会回避跳过或者留下空白，这是接受自己的第一步。

提供持续学习的动力

例如，我为自己设限每天写一千字，信息的不断输出给我带来恐惧，我害怕有一天我写无可写，于是我不停地阅读，通过个人的知识管理促使自己不断学习，提高核心竞争力。 详细的知识管理可以看我的这篇文章：《个人知识管理的方法》，回复「知识」可见

积累更多的知识

写并不是单纯的写。 例如你写着写着，你突然忘记了一个概念，于是上网找，找回来这个概念的时候，你重温这个概念，可能还会顺便看了一下这个概念的其他东西。 例如你需要获取第一手的资料，寻找信息来源本身就是一个知识积累的过程，同时，你慢慢就学会了鉴别知识：什么是没有用的心灵鸡汤，什么是不值得关注的吐槽名人，还有，在这个过程中，你还养成你的心智。

提高将事情讲清楚的能力

很多东西你以为懂了，但当你在写下来的时候，你就觉得无从下手了。

如果一件事情你不能讲清楚，十有八九你还没有完全理解。

将事情写下来，慢慢就可以提高你的逻辑思维能力，分析能力，写会迫使你在你脑中搭建一个有条理的框架。例如我写这篇文章一样，我就将值得写博客的原因一点一点地罗列出来，事情就更加清晰，你也可以更好的思考问题。

分享带来的连锁反应

“通过分享，你获得了直接而快速的回报，你最终或许会发现你已将版权和“保留所有权利”抛诸脑后。新的经济学准则是：参与你作品的人越多，回报越高。在分享主义里，如果你愿意你可以保留所有权，但是我乐于分享。” by 毛向辉 《分享主义：一场思维革命》

互联网精神其中最重要的就是分享主义，基于分享主义，你可以享受到社会化及互联网给你带来的种种便利和好处，你分享了一个知识，你就成为了互联网中的一个点，这个点的大小由你自己来决定，互联网的大潮会将你的这个点推送到它所能触及的每个角落，让需要的人得到，同时，你的这个点也会继续扩大，连接到整个网络，这个点有可能连接成一张网，而你就是这张网的中心。

帮你找到志同道合的人

在微博，在朋友圈，你可能找不到跟你志同道合的人，而在博客，你可以通过看他的几篇文章就迅速地理解认同这个人，即使你没有见过这个人，但你也可以通过这种关联来相互学习。 如果你在一个领域有相当的了解，你将这些内容发在网络上，网络上跟你志趣相投的人也会被你吸引过来，根据吸引力法则，你是怎样的人你就被怎么样的人吸引，这就是博客所能赋予你的魅力。

即使博客没有被他人关注，我们依然可以找到同好，你可以自己将博文转载到其他站点，人们会通过搜索引擎找到你，有邮件、微博等工具，我们不乏与他人交流的途径。by Gabriel Weinberg《Why I blog》

记录成长

隔一段时间，你再回头看你写的博客，你会发现自己正在通过这样的方式在不断的成长，这种成长在自己眼里是一种财富，在别人眼里是一张地图，你得到了收获，不断修正自己的错误，别人得到了指引，避免走弯路。 更多的情况是当你回望自己的时候你会发现自己是一个傻逼，so what，that is what I am！

培养持续做一件事情的能力

开始是坚持，后来是习惯，接着喜欢。以后当有人对你说，「你写那么多有用的东西，你真的很厉害啊！」你可以笑而不语，也可以大声说道：「你妹，你不知道我开始的时候多么痛苦！」 让你长久地去跑步，你可能做不到；让你每个月看一本书，你也可能做不到；但让你持续地写一个博客，你可以做得到。 你不相信？你不试试你怎么知道？ 默默地持续做一件事是一种难得的能力，也是一种难得的品质。

讨论反思

每人都会有思维的盲点，就好像这篇文章一样，可能你觉得我可能说得不对，你可以反驳我，我欢迎这种讨论，因为讨论的过程中会产生各种的思维的碰撞，这种碰撞会让你反思，也会激发出你新的灵感，这种讨论反思给自己的带来巨大的受益。 互联网给你的反馈就是让你承受更多，接受更多，成为一个更好的人。

搜寻到你意想不到东西

世界不止是你的家，你的公司，你的朋友圈，你应该去发现一个更大的世界，通过写博客，你会知道世界上还有很多人像你一样在写博客，这些人和知识正在世界的某个角落在等着你。 例如，在写这篇文章的过程中，我才知道了Gabriel Weinberg，我才要将阳志平的博客重读一遍。写的过程会让你有很多新的发现，这些新的发现都值得你去再写下来，总结分享出去。

一个人在做一件属于自己的事

很多你认为自己很牛逼的事情都是自己一个人做出来。 别人在刷微博，你在看书，别人在看穿越剧，你在学英文，别人在去唱K，你在写个人总结。吃饭也要找同伴，出游要找同伴，看电影要找同伴，你上一次一个人在做一件属于自己的事是在什么时候？

如果你想要清晰地思考，就必须远离人群。但是走得越远，你的处境就会越困难，收到的阻力也会越大。因为你没有迎合社会习俗，而是一步步地与它背道而驰。如果自己就是潮水的一部分 ，怎么能看见潮流的方向呢？你只能永远保持质疑，问自己，什么话是我不能说的？为什么？——Paul Graham《不能说的话》

互联网的身份识别：

一个长期的价值博客是一份很好的简历。这里的“简历”并非是狭义上的求职简历，毕竟现在还没有到价值博客的时代，很多人写博客都是到处转载或者干脆碎碎念，正因此面试官未必拿个人博客当成了解一个人的更可靠窗口。 这里的“简历”是指一个让别人了解自己的窗口，虽然我们未必做得到像罗永浩、Keso这样的博客，个人的影响力已经足以支撑出一份事业（牛博和5gme），但至少你会因此而结识更多的人，你的博客价值越高，你结识的人就越牛，跟牛人交流又会让你的眼界得到极大的开阔，打开一扇又一扇你原本不知道的门，于是你就变得更牛… 这是一个良性循环。by 刘未鹏

最后

你可能想不到在白纸的左边（不值得写博客的原因）写什么了，想不到写个「博客时代已经过去」或者「我没有时间」也可以，但与此同时，你也可以用那些时间去思考一下「怎么做到长期写一个价值博客」。 如果你不想思考，也可以回复「价值」看看别人的建议。 推荐写作平台：

• 简书（推荐）
• 自己搭建一个独立博客
• 新浪博客

丢失的博客数据

我从2012年开始建博客。从最开始的免费空间不断的测试、不同博客系统不同主题来回折腾好久之后，才开始专心写点东西。刚开始没什么好些的，就写点生活中的事，转转鸡汤，所以也不太在乎数据之类的东西。后来主机ip被墙就基本忘记博客这回事了，14年6月份美国主机到期未继续续费，等反应过来时已经什么都没有了。 今天安装七牛加速，却意外的找回了两年前的几篇博文，因为只缓存了一个静态页面，所以只显示了主机当时第一页的几篇文章，14年之前的文章还是丢失了。看当时的几篇文章，却很有感悟，更觉得要把博客坚持下去。

崩溃的macbook

半个月之前，我的macbook系统文件损坏，电脑里的大量的代码、文档全部无法取出，连续通宵想办法解决问题，最后还是找了个空硬盘把整个电脑200多G的资料全部打包备份再重装系统。这还不算完，上百G的资料整理归类又花了几天时间。 时常整理整理资料，随手记记，养成好习惯，尤为重要。

安装Disable Google Fonts屏蔽谷歌

方法一：搜索这个插件“ Disable Google Fonts ”，安装并激活，对于某些网站是管用的，但我管理的几个WordPress网站，用此插件无效。  

安装Replace-Google-Fonts插件替换

方法二：使用replace-google-fonts小插件，使用奇虎360的开放字体服务来替换Google的开放字体服务。 下载Replace-Google-Fonts  

手动修改script替换为国内地址

方法三：修改这个文件 \wp-includes\script-loader.php，找到：fonts.googleapis，替换成：fonts.useso 做了这一步，有几个网站后台速度正常了，但是不是所有的WordPress网站都能找到这句话。  

手动修改functions.php屏蔽谷歌代码

方法四：在主题目录的这个文件functions.php中加载一段代码，就可以有效的屏蔽谷歌代码，代码如下： //禁用Open Sans class Disable_Google_Fonts { public function __construct() { add_filter( ‘gettext_with_context’, array( $this, ‘disable_open_sans’ ), 888, 4 ); } public function disable_open_sans( $translations, $text, $context, $domain ) { if ( ‘Open Sans font: on or off’ == $context && ‘on’ == $text ) { $translations = ‘off’; } return $translations; } } $disable_google_fonts = new Disable_Google_Fonts; 或者下面这段代码也可以： function remove_open_sans_from_wp_core() { wp_deregister_style( ‘open-sans’ ); wp_register_style( ‘open-sans’, false ); wp_enqueue_style(‘open-sans’,”); } add_action( ‘init’, ‘remove_open_sans_from_wp_core’ );  

搜索所有代码替换

最后一个方法，最彻底，最有效的方法： 就是把主题文件都下载下来，用Dreamweaver对整个目录进行代码搜索，然后逐一替换，实际上也就几个文件中存在。 有一些插件比如那个革命banner插件也使用了谷歌字体，把他的目录同样替换一下。这样你的网站，不论是前台还是后台都比以前还要快，因为谷歌字体插件变成国内了，而且保留了美观度和功能。

wordpress 搬迁常见问题及解决方案大全 经常搬迁，总结总结经验，本文会不断更新。

数据库连接出错

修改文件目录下 wp-config.php，填入正确的数据库连接信息。

1
2
3
4
5
6
7
8
9
10
11
12

// ** MySQL 设置 - 具体信息来自您正在使用的主机 ** //
/** WordPress数据库的名称 */
define('DB_NAME', 'wordpress');

/** MySQL数据库用户名 */
define('DB_USER', 'root');

/** MySQL数据库密码 */
define('DB_PASSWORD', '123');

/** MySQL主机 */
define('DB_HOST', 'localhost’);

WP Super Cache 错误

WP Super Cache：这个插件，在搬家后，需要重新安装WP Super Cache 。 登入FTP空间删除文件wp-content/wp-cache-config.php和wp-content/advanced-cache.php 编辑文件wp-config.php，删除以下两行开头的代码： define(‘WP_CACHE’,true); define(‘WPCACHEHOME’,’ 然后重新安装WP Super Cache即可。

更换域名问题

需要修改数据库中，wp_options表中的home和siteurl两个字短的值为当前域名地址。

排版错乱问题

首先，我们需要检查一下网站的PHP版本设置是否正确，WordPress的话，一般是使用5.3或者5.4的PHP版本，如果是5.2的话，是有可能导致网站排版混乱的问题。以许滋博客使用的阿里云为例，登录到控制面板，在select php version 处修改为5.3版本即可。

网站主页可访问，其他页面提示404错误

也可能提示为 The requested URL was not found on this server 登录主机空间控制面板，在文件管理处开启查看隐藏文件，查看.htaccess是否有正确的内容。一般初始化的.htaccess文件内容为：

1
2
3
4
5
6
7
8
9

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /WP/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /WP/index.php [L]
</IfModule># END WordPress

如果有设置重定向或者静态链接之类的也需要添加与之前网站相同的内容。

说到音乐应该是每个博客都不可缺少的，在Wordpress文章或者日记中插入音乐是算基本需求了。本文介绍在wordpress添加音乐播放器的hermit插件，所添加的播放器不但支持html5，也可以自适应。

Hermit播放器插件实现音乐播放器

Hermit音乐播放器插件支持网易云音乐，虾米音乐和本地音乐，你可以直接在文章中插入来自虾米或者网易云音乐的歌曲到文章中。先来看看Hermit音乐播放器插件的效果吧！ [hermit auto=”0” loop=”0” unexpand=”0” fullheight=”0”]songlist#:1775751240[/hermit]  

整站Ajax的播放设置

可以在javascript中设置音乐是否打断播放，当然ajax效果是不打断播放的。

1
2
3
4

if( window.hermitjs !== undefined ){
hermitjs.reload(0) //默认方式, 会打断播放状态
hermitjs.reload(1) //不会打断播放,音乐会继续播放
}

简单的使用介绍

在撰写文章的时候，就可以点击添加音乐的按钮来输入音乐地址。输入好了，点击插入音乐即可自动完成操作，发布文章的时候也就有了音乐。 添加多个音乐，则回车空行如下图，以网易云音乐为例子： 以上，喜欢音乐分享的朋友可以去试试啦！

优化样式

如果你也想和我一样，给封面图片加上唱片旋转效果，可以参考本站的css代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

@-webkit-keyframes rotate{
from{-webkit-transform:rotate(0deg)}
to{-webkit-transform:rotate(360deg)}
}
@-moz-keyframes rotate{
from{-moz-transform:rotate(0deg)}
to{-moz-transform:rotate(360deg)}
}
@-ms-keyframes rotate{
from{-ms-transform:rotate(0deg)}
to{-ms-transform:rotate(360deg)}
}
@-o-keyframes rotate{
from{-o-transform:rotate(0deg)}
to{-o-transform:rotate(360deg)}
}
.hermit-cover-image{
border-radius:99%;
animation: 9.8s linear 0s normal none infinite rotate;
-webkit-animation:9.8s linear 0s normal none infinite rotate;
}

把以上代码放在主题的style.css中即可，这样Hermit插件即使更新了样式也会保存下来。

虚机问题

昨天虚机上传网页，打开测试页面的时候出现如下错误： Forbidden. You don’t have permission to access /index.html on this server. 开始我以为我网页出错，后来发现是权限问题，立马搞定了. 原因：index.html是用root用户建的文件，虚机上权限限制且无法修改，只能修改网页访问权限。 解决方法： 更改文件权限：chmod 755 index.html 或者在ftp软件中设置该文件权限

配置修改

如果是WinServer下出现这个问题,请打开apache下配置文件httpd.conf，找到：

1
2
3
4
5
6

<Directory />
     Options FollowSymLinks
     AllowOverride None
     Order deny,allow
     deny from all
</Directory>

然后试着把deny from all中的deny改成了allow，保存后重起apache，测试网站就可以访问了。

.webloc文件是MAC OS（苹果)操作系统里的浏览器创建的网址快捷方式，我经常在很多软件镜像里看到这个文件，那么如何做一个.webloc快捷方式文件呢-。-

制作方法一:

使用文本编辑器写入以下代码：

1
2
3
4
5
6
7
8

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>URL</key>
    <string>http://www.xuzizi.cn</string>
</dict>
</plist>

保存成.webloc文件即可。

制作方法二：

打开safari，输入你需要生成链接的网址。通过拖拽浏览器地址栏左侧的网址图标到桌面上即生成了.webloc文件。还可以直接拖拽到Dock栏中。

添加Logo：

以上这两种方法都没有办法生成带Logo快捷方式，那么如何给.webloc添加你所需要的icon呢？

1. 用“预览”打开你所要设置的图标文件，全选图片（command+a)，复制（command+c）
2. 在finder里选中通过上述方法生成的.webloc文件
3. 按commond+i弹出文件简介面板，用鼠标点住左上角的空白图标，并粘贴command+v。

这样就完成了生成带图标的webloc文件了。

Markdown: Basics （快速入门）(点击查看完整语法说明)

Getting the Gist of Markdown’s Formatting Syntax

此页提供了 Markdown 的简单概念， 语法说明 页提供了完整详细的文档，说明了每项功能。但是 Markdown 其实很简单就可以上手，此页文档提供了一些范例，并且每个范例都会提供输出的 HTML 结果。 其实直接试试看也是一个很不错的方法， Dingus 是一个网页应用程序，你可以把自已编写的 Markdown 文档转成 XHTML。

段落、标题、区块代码

一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。 Markdown 支持两种标题的语法，Setext 和 atx 形式。Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。 区块引用则使用 email 形式的 ‘>’ 角括号。 Markdown 语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

A First Level Header
====================
A Second Level Header
---------------------

Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.

The quick brown fox jumped over the lazy
dog's back.
### Header 3

> This is a blockquote.
> 
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

输出 HTML 为：

1
2
3
4
5
6
7
8
9
10
11
12
13

<h1>A First Level Header</h1>
<h2>A Second Level Header</h2>
<p>Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.</p>
<p>The quick brown fox jumped over the lazy
dog's back.</p>
<h3>Header 3</h3>
<blockquote>
<p>This is a blockquote.</p>
<p>This is the second paragraph in the blockquote.</p>
<h2>This is an H2 in a blockquote</h2>
</blockquote>

修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。 Markdown 语法:

1
2
3
4

Some of these words *are emphasized*.
Some of these words _are emphasized also_.
Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.

输出 HTML 为:

1
2
3
4

<p>Some of these words <em>are emphasized</em>.
Some of these words <em>are emphasized also</em>.</p>
<p>Use two asterisks for <strong>strong emphasis</strong>.
Or, if you prefer, <strong>use two underscores instead</strong>.</p>

列表

无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号：

1
2
3

* Candy.
* Gum.
* Booze.

加号：

1
2
3

+ Candy.
+ Gum.
+ Booze.

和减号

1
2
3

- Candy.
- Gum.
- Booze.

都会输出 HTML 为：

1
2
3
4
5

<ul>
<li>Candy.</li>
<li>Gum.</li>
<li>Booze.</li>
</ul>

有序的列表则是使用一般的数字接着一个英文句点作为项目标记：

1
2
3

1. Red
2. Green
3. Blue

输出 HTML 为：

1
2
3
4
5

<ol>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ol>

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

1
2
3
4
5

* A list item.

    With multiple paragraphs.

* Another item in the list.

输出 HTML 为：

1
2
3
4
5

<ul>
<li><p>A list item.</p>
<p>With multiple paragraphs.</p></li>
<li><p>Another item in the list.</p></li>
</ul>

链接

Markdown 支援两种形式的链接语法： 行内 和 参考 两种形式，两种都是使用角括号来把文字转成连结。 行内形式是直接在后面用括号直接接上链接：

1

This is an [example link](http://example.com/).

输出 HTML 为：

1
2

<p>This is an <a href="http://example.com/">
example link</a>.</p>

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

1

This is an [example link](http://example.com/ "With a Title").

输出 HTML 为：

1
2

<p>This is an <a href="http://example.com/" title="With a Title">
example link</a>.</p>

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

1
2
3
4
5
6

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"

输出 HTML 为：

1
2
3
4

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from <a href="http://search.yahoo.com/"
title="Yahoo Search">Yahoo</a> or <a href="http://search.msn.com/"
title="MSN Search">MSN</a>.</p>

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

1
2
3
4

I start my morning with a cup of coffee and
[The New York Times][NY Times].

[ny times]: http://www.nytimes.com/

输出 HTML 为：

1
2

<p>I start my morning with a cup of coffee and
<a href="http://www.nytimes.com/">The New York Times</a>.</p>

图片

图片的语法和链接很像。 行内形式（title 是选择性的）：

1

![alt text](/path/to/img.jpg "Title")

参考形式：

1
2
3

![alt text][id]

[id]: /path/to/img.jpg "Title"

上面两种方法都会输出 HTML 为：

1

<img src="/path/to/img.jpg" alt="alt text" title="Title" />

代码

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

1
2
3
4

I strongly recommend against using any `<blink>` tags.

I wish SmartyPants used named entities like `&mdash;`
instead of decimal-encoded entites like `&#8212;`.

输出 HTML 为：

1
2
3
4
5

<p>I strongly recommend against using any
<code>&lt;blink&gt;</code> tags.</p>
<p>I wish SmartyPants used named entities like
<code>&amp;mdash;</code> instead of decimal-encoded
entites like <code>&amp;#8212;</code>.</p>

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

1
2
3
4
5
6

If you want your page to validate under XHTML 1.0 Strict,
you've got to put paragraph tags in your blockquotes:

<blockquote>
<p>For example.</p>
</blockquote>

输出 HTML 为：

1
2
3
4
5
6

<p>If you want your page to validate under XHTML 1.0 Strict,
you've got to put paragraph tags in your blockquotes:</p>
<pre><code>&lt;blockquote&gt;
&lt;p&gt;For example.&lt;/p&gt;
&lt;/blockquote&gt;
</code></pre>

文章转载自 Markdown: Basics （快速入门）

Markdown 语法说明 (简体中文版) / (点击查看快速入门)

• 概述
  • 宗旨
  • 兼容 HTML
  • 特殊字符自动转换
• 区块元素
  • 段落和换行
  • 标题
  • 区块引用
  • 列表
  • 代码区块
  • 分隔线
• 区段元素
  • 链接
  • 强调
  • 代码
  • 图片
• 其它
  • 反斜杠
  • 自动链接
• 感谢
• Markdown 免费编辑器

概述

宗旨

Markdown 的目标是实现「易读易写」。 可读性，无论如何，都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，而最大灵感来源其实是纯文本电子邮件的格式。 总之， Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。比如：在文字两旁加上星号，看起来就像*强调*。Markdown 的列表看起来，嗯，就是列表。Markdown 的区块引用看起来就真的像是引用一段文字，就像你曾在电子邮件中见过的那样。

兼容 HTML

Markdown 语法的目标是：成为一种适用于网络的_书写_语言。 Markdown 并不是想取代 HTML的地位，甚至接近它。它的语法种类很少，只对应 HTML 标记的一小部分。Markdown 的构想_不是_要使得 HTML 文档更容易书写。在我看来， HTML 已经很容易写了。Markdown 的理念是，能让文档更容易读、写和随意改。HTML 是一种_发布_的格式，Markdown 是一种_书写_的格式。就这样，Markdown 的格式语法只涵盖纯文本可以涵盖的范围。 不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。 要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的 <p> 标签。 例子如下，在 Markdown 文件里加上一段 HTML 表格：

1
2
3
4
5
6
7
8
9

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

请注意，在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如，你在 HTML 区块内使用 Markdown 样式的*强调*会没有效果。 HTML 的区段（行内）标签如 <span>、<cite>、<del> 可以在 Markdown 的段落、列表或是标题里随意使用。依照个人习惯，甚至可以不用 Markdown 格式，而直接采用 HTML 标签来格式化。举例说明：如果比较喜欢 HTML 的 <a> 或 <img> 标签，可以直接使用这些标签，而不用 Markdown 提供的链接或是图像标签语法。 和处在 HTML 区块标签间不同，Markdown 语法在 HTML 区段标签间是有效的。

特殊字符自动转换

在 HTML 文件中，有两个字符需要特殊处理： < 和 & 。 < 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要显示这些字符的原型，你必须要使用实体的形式，像是 < 和 &。 & 字符尤其让网络文档编写者受折磨，如果你要打「AT&T」 ，你必须要写成「AT&T」。而网址中的 & 字符也要转换。比如你要链接到：

1

http://images.google.com/images?num=30&q=larry+bird

你必须要把网址转换写为：

1

http://images.google.com/images?num=30&q=larry+bird

才能放到链接标签的 href 属性里。不用说也知道这很容易忽略，这也可能是 HTML 标准检验所检查到的错误中，数量最多的。 Markdown 让你可以自然地书写字符，需要转换的由它来处理好了。如果你使用的 & 字符是 HTML 字符实体的一部分，它会保留原状，否则它会被转换成 &amp;。 所以你如果要在文档中插入一个版权符号 ©，你可以这样写：

1

©

Markdown 会保留它不动。而若你写：

1

AT&T

Markdown 就会将它转为：

1

AT&T

类似的状况也会发生在 < 符号上，因为 Markdown 允许 兼容 HTML ，如果你是把 < 符号作为 HTML 标签的定界符使用，那 Markdown 也不会对它做任何转换，但是如果你写：

1

4 < 5

Markdown 将会把它转换为：

1

4 < 5

不过需要注意的是，code 范围内，不论是行内还是区块， < 和 & 两个符号都_一定_会被转换成 HTML 实体，这项特性让你可以很容易地用 Markdown 写 HTML code （和 HTML 相对而言， HTML 语法中，你要把所有的 < 和 & 都转换为 HTML 实体，才能在 HTML 文件里面写出 HTML code。）

区块元素

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。 「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行（插入换行符），这个特性和其他大部分的 text-to-HTML 格式不一样（包括 Movable Type 的「Convert Line Breaks」选项），其它的格式会把每个换行符都转成 <br /> 标签。 如果你_确实_想要依赖 Markdown 来插入 <br /> 标签的话，在插入处先按入两个以上的空格然后回车。 的确，需要多费点事（多加空格）来产生 <br /> ，但是简单地「每个换行都转换为 <br />」的方法在 Markdown 中并不适合， Markdown 中 email 式的 区块引用 和多段落的 列表 在使用换行来排版的时候，不但更好用，还更方便阅读。

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。 类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

1
2
3
4
5

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

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

任何数量的 = 和 - 都可以有效果。 类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

1
2
3
4
5

# 这是 H1

## 这是 H2

###### 这是 H6

你可以选择性地「闭合」类 atx 样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上 #，而行尾的 # 数量也不用和开头一样（行首的井字符数量决定标题的阶数）：

1
2
3
4
5

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

区块引用 Blockquotes

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一个区块引用，那会看起来像是你自己先断好行，然后在每行的最前面加上 > ：

1
2
3
4
5
6

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > ：

1
2
3
4
5
6

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ：

1
2
3
4
5

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：

1
2
3
4
5
6
7
8

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input  $markdown_script");

任何像样的文本编辑器都能轻松地建立 email 型的引用。例如在 BBEdit 中，你可以选取文字后然后从选单中选择_增加引用阶层_。

列表

Markdown 支持有序列表和无序列表。 无序列表使用星号、加号或是减号作为列表标记：

1
2
3

*   Red
*   Green
*   Blue

效果就是

• red
• green
• blue

等同于：

1
2
3

+   Red
+   Green
+   Blue

也等同于：

1
2
3

-   Red
-   Green
-   Blue

有序列表则使用数字接着一个英文句点：

1
2
3

1.  Bird
2.  McHale
3.  Parish

很重要的一点是，你在列表标记上使用的数字并不会影响输出的 HTML 结果，上面的列表所产生的 HTML 标记为：

1
2
3
4
5

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

如果你的列表标记写成：

1
2
3

1.  Bird
1.  McHale
1.  Parish

或甚至是：

1
2
3

3. Bird
1. McHale
8. Parish

你都会得到完全相同的 HTML 输出。重点在于，你可以让 Markdown 文件的列表数字和输出的结果相同，或是你懒一点，你可以完全不用在意数字的正确性。 如果你使用懒惰的写法，建议第一个项目最好还是从 1. 开始，因为 Markdown 未来可能会支持有序列表的 start 属性。 列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。 要让列表看起来更漂亮，你可以把内容用固定的缩进整理好：

1
2
3
4
5

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

但是如果你懒，那也行：

1
2
3
4
5

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

如果列表项目间用空行分开，在输出 HTML 时 Markdown 就会将项目内容用 <p> 标签包起来，举例来说：

1
2

*   Bird
*   Magic

会被转换为：

1
2
3
4

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

但是这个：

1
2
3

*   Bird

*   Magic

会被转换为：

1
2
3
4

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符：

1
2
3
4
5
6
7
8
9

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

如果你每行都有缩进，看起来会看好很多，当然，再次地，如果你很懒惰，Markdown 也允许：

1
2
3
4
5
6
7

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

如果要在列表项目内放进引用，那 > 就需要缩进：

1
2
3
4

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

如果要放代码区块的话，该区块就需要缩进_两次_，也就是 8 个空格或是 2 个制表符：

1
2
3

*   一列表项包含一个列表区块：

        <代码写在这>

当然，项目列表很可能会不小心产生，像是下面这样的写法：

1

1986. What a great season.

换句话说，也就是在行首出现_数字-句点-空白_，要避免这样的状况，你可以在句点前面加上反斜杠。

1

1986\. What a great season.

代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，Markdown 会用 <pre> 和 <code> 标签来把代码区块包起来。 要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以，例如，下面的输入：

1
2
3

这是一个普通段落：

    这是一个代码区块。

Markdown 会转换成：

1
2
3
4

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

这个每行一阶的缩进（4 个空格或是 1 个制表符），都会被移除，例如：

1
2
3
4
5

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

会被转换为：

1
2
3
4
5
6

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。 在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，例如：

1
2
3

<div class="footer">
    &copy; 2004 Foo Corporation
</div>

会被转换为：

1
2
3
4

<pre><code>&lt;div class="footer"&gt;
    &amp;copy; 2004 Foo Corporation
&lt;/div&gt;
</code></pre>

代码区块中，一般的 Markdown 语法不会被转换，像是星号便只是星号，这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

1
2
3
4
5
6
7
8
9

* * *

***

*****

- - -

---------------------------------------

区段元素

链接

Markdown 支持两种形式的链接语法： _行内式_和_参考式_两种形式。 不管是哪一种，链接文字都是用 [方括号] 来标记。 要建立一个_行内式_的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

1
2
3

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

会产生：

1
2
3
4
5

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

如果你是要链接到同样主机的资源，你可以使用相对路径：

1

See my [About](/about/) page for details.   

_参考式_的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：

1

This is [an example][id] reference-style link.

你也可以选择性地在两个方括号中间加上一个空格：

1

This is [an example] [id] reference-style link.

接着，在文件的任意处，你可以把这个标记的链接内容定义出来：

1

[id]: http://example.com/  "Optional Title Here"

链接内容定义的形式为：

• 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
• 接着一个冒号
• 接着一个以上的空格或制表符
• 接着链接的网址
• 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

下面这三种链接的定义都是相同：

1
2
3

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

请注意：有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的链接 title。 链接网址也可以用尖括号包起来：

1

[id]: <http://example.com/>  "Optional Title Here"

你也可以把 title 属性放到下一行，也可以加一些缩进，若网址太长的话，这样会比较好看：

1
2

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

网址定义只有在产生链接的时候用到，并不会直接出现在文件之中。 链接辨别标签可以有字母、数字、空白和标点符号，但是并_不_区分大小写，因此下面两个链接是一样的：

1
2

[link text][a]
[link text][A]

_隐式链接标记_功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号，如果你要让 “Google” 链接到 google.com，你可以简化成：

1

[Google][]

然后定义链接内容：

1

[Google]: http://google.com/

由于链接文字可能包含空白，所以这种简化型的标记内也许包含多个单词：

1

Visit [Daring Fireball][] for more information.

然后接着定义链接：

1

[Daring Fireball]: http://daringfireball.net/

链接的定义可以放在文件中的任何一个地方，我比较偏好直接放在链接出现段落的后面，你也可以把它放在文件最后面，就像是注解一样。 下面是一个参考式链接的范例：

1
2
3
4
5
6

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

如果改成用链接名称的方式写：

1
2
3
4
5
6

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

上面两种写法都会产生下面的 HTML。

1
2
3
4

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

下面是用行内式写的同样一段内容的 Markdown 文件，提供作为比较之用：

1
2
3

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

参考式的链接其实重点不在于它比较好写，而是它比较好读，比较一下上面的范例，使用参考式的文章本身只有 81 个字符，但是用行内形式的却会增加到 176 个字元，如果是用纯 HTML 格式来写，会有 234 个字元，在 HTML 格式中，标签比文本还要多。 使用 Markdown 的参考式链接，可以让文件更像是浏览器最后产生的结果，让你可以把一些标记相关的元数据移到段落文字之外，你就可以增加链接而不让文章的阅读感觉被打断。

强调

Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 <em> 标签包围，用两个 * 或 _ 包起来的话，则会被转成 <strong>，例如：

1
2
3
4
5
6
7

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

会转成：

1
2
3
4
5
6
7

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

你可以随便用你喜欢的样式，唯一的限制是，你用什么符号开启标签，就要用什么符号结束。 强调也可以直接插在文字中间：

1

un*frigging*believable

但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。 如果要在文字前后直接插入普通的星号或底线，你可以用反斜线：

1

\*this text is surrounded by literal asterisks\*

代码

如果要标记一小段行内代码，你可以用反引号把它包起来（`），例如：

1

Use the `printf()` function.

会产生：

1

<p>Use the <code>printf()</code> function.</p>

如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：

1

``There is a literal backtick (`) here.``

这段语法会产生：

1

<p><code>There is a literal backtick (`) here.</code></p>

代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号：

1
2
3

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

会产生：

1
2
3

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

在代码区段内，& 和尖括号都会被自动地转成 HTML 实体，这使得插入 HTML 原始码变得很容易，Markdown 会把下面这段：

1

Please don't use any `<blink>` tags.

转为：

1

<p>Please don't use any <code>&lt;blink&gt;</code> tags.</p>

你也可以这样写：

1

`—` is the decimal-encoded equivalent of `—`.

以产生：

1
2

<p><code>&amp;#8212;</code> is the decimal-encoded
equivalent of <code>&amp;mdash;</code>.</p>

图片

很明显地，要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。 Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： _行内式_和_参考式_。 行内式的图片语法看起来像是：

1
2
3

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下：

• 一个惊叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 ‘title’ 文字。

参考式的图片语法则长得像这样：

1

![Alt text][id]

「id」是图片参考的名称，图片参考的定义方式则和链接参考一样：

1

[id]: url/to/image  "Optional title attribute"

到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 <img> 标签。

其它

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：

1

<http://example.com/>

Markdown 会转为：

1

<a href="http://example.com/">http://example.com/</a>

邮址的自动链接也很类似，只是 Markdown 会先做一个编码转换的过程，把文字字符转成 16 进位码的 HTML 实体，这样的格式可以糊弄一些不好的邮址收集机器人，例如：

1

<address@example.com>

Markdown 会转成：

1
2
3
4

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

在浏览器里面，这段字串（其实是 <a href="mailto:address@example.com">address@example.com</a>）会变成一个可以点击的「address@example.com」链接。 （这种作法虽然可以糊弄不少的机器人，但并不能全部挡下来，不过总比什么都不做好些。不管怎样，公开你的信箱终究会引来广告信件的。）

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），你可以在星号的前面加上反斜杠：

1

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

1
2
3
4
5
6
7
8
9
10
11
12

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

感谢

感谢 leafy7382 协助翻译，hlb、Randylien 帮忙润稿，ethantw 的汉字标准格式・CSS Reset， WM 回报文字错误。 感谢 fenprace，addv。 ———-

Markdown 免费编辑器

Windows 平台

• MarkdownPad
• MarkPad

Linux 平台

• ReText

Mac 平台

• Mou

在线编辑器

• Markable.in
• Dillinger.io

浏览器插件

• MaDe (Chrome)

高级应用

• Sublime Text 2 + MarkdownEditing / 教程

  文章转载自Markdown 语法说明 (简体中文版)