Markdown语法

作者: 晴明_ | 来源:发表于2015-11-18 12:46 被阅读12171次

摘自:https://github.com/guodongxiaren/README

该文件用来测试和展示书写README的各种markdown语法。GitHub的markdown语法在标准的markdown语法基础上做了扩充,称之为GitHub Flavored Markdown。简称GFM,GFM在GitHub上有广泛应用,除了README文件外,issues和wiki均支持markdown语法。


Author:Jelly

E-mail:879231132@qq.com

===========================

<a name="index"/>目录

<a name="line"/>

***、---、___显示虚横线




<a name="title"/>

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

<a name="text"/>显示文本

普通文本

这是一段普通的文本

关于换行

直接回车不能换行,

可以使用<br>。
但是使用html标签就丧失了markdown的意义。
可以在上一行文本后面补两个空格,
这样下一行的文本就换行了。

或者就是在两行文本直接加一个空行。

也能实现换行效果,不过这个行间距有点大。

单行文本

Hello,大家好,我是果冻虾仁。

文本块

欢迎到访
很高兴见到您
祝您,早上好,中午好,下午好,晚安

部分文字高亮

Thank You . Please Call Me Coder

高亮功能更适合做一篇文章的tag

例如:

java 网络编程 Socket 全双工

删除线

这是一个 删除线

斜体

斜体1

斜体2

粗体

粗体1

粗体2

组合使用粗体、斜体和删除线

斜粗体1

斜粗体2

斜粗体删除线1

斜粗体删除线2

<a name="link"/>链接

链接外部URL

我的博客 语法如下:

[我的博客](http://blog.csdn.net/guodongxiaren "悬停显示")

链接的另一种写法

我的博客

语法如下:

[我的博客][id]
[id]:http://blog.csdn.net/guodongxiaren "悬停显示"

中括号[ ]里的id,可以是数字,字母等的组合。这两行可以不连着写,一般把第二行的链接统一放在文章末尾,id上下对应就行了。这样正文看起来会比较干净。

链接本仓库里的URL

Book
语法如下:

[Book](./Book)

如果文件要引用的文件不存在,则待点击的文本为红色。引用的文件存在存在则文本为蓝色。

锚点

我们可以使用HTML的锚点标签(#)来设置锚点:回到目录
但其实呢,每一个标题都是一个锚点,不需要用标签来指定,比如我们 回到顶部
不过不幸的是,由于对中文支持的不好,所以中文标题貌似是不能视作标签的。

<a name="pic"/>显示图片

来源于网络的图片

baidubaidu

GitHub仓库中的图片

<a name="piclink">给图片加上超链接

第一种

![head]
[head]:https://github.com/guodongxiaren/ImageCache/raw/master/Logo/jianxin.jpg "点击图片进入我的博客"

第二种

内容任意内容任意

<a name="dot"/>列表

圆点列表

  • 昵称:果冻虾仁
  • 别名:隔壁老王
  • 英文名:Jelly

更多圆点

  • 编程语言
    • 脚本语言
      • Python

数字列表

一般效果

就是在数字后面加一个点,再加一个空格。不过看起来起来可能不够明显。
面向对象的三个基本特征:

  1. 封装
  2. 继承
  3. 多态

数字列表自动排序

也可以在第一行指定1.,而接下来的几行用星号*(或者继续用数字1. )就可以了,它会自动显示成2、3、4……。
面向对象的七大原则:

  1. 开闭原则
  • 里氏转换原则
  • 依赖倒转原则
  • 接口隔离原则
  • 组合/聚合复用原则
  • “迪米特”法则
  • 单一直则原则

多级数字列表

和圆点的列表一样,数字列表也有多级结构:

  1. 这是一级的数字列表,数字1还是1
    1. 这是二级的数字列表,阿拉伯数字在显示的时候变成了罗马数字
      1. 这是三级的数字列表,数字在显示的时候变成了英文字母
      2. 四级的数字列表显示效果,就不再变化了,依旧是英文字母

复选框列表

  • [x] C
  • [x] C++
  • [x] Java
  • [x] Qt
  • [x] Android
  • [ ] C#
  • [ ] .NET

您可以使用这个功能来标注某个项目各项任务的完成情况。

<a name="blockquotes"/>块引用

常用于引用文本

文本摘自《深入理解计算机系统》P27

令人吃惊的是,在哪种字节顺序是合适的这个问题上,人们表现得非常情绪化。实际上术语“little endian”(小端)和“big endian”(大端)出自Jonathan Swift的《格利佛游记》一书,其中交战的两个派别无法就应该从哪一端打开一个半熟的鸡蛋达成一致。因此,争论沦为关于社会政治的争论。只要选择了一种规则并且始终如一的坚持,其实对于哪种字节排序的选择都是任意的。

<b>“端”(endian)的起源</b>

以下是Jonathan Swift在1726年关于大小端之争历史的描述:

“……下面我要告诉你的是,Lilliput和Blefuscu这两大强国在过去36个月里一直在苦战。战争开始是由于以下的原因:我们大家都认为,吃鸡蛋前,原始的方法是打破鸡蛋较大的一端,可是当今的皇帝的祖父小时候吃鸡蛋,一次按古法打鸡蛋时碰巧将一个手指弄破了,因此他的父亲,当时的皇帝,就下了一道敕令,命令全体臣民吃鸡蛋时打破较小的一端,违令者重罚。”

块引用有多级结构

数据结构

二叉树

平衡二叉树

满二叉树

<a name="code"/>代码高亮

public static void main(String[]args){} //Java
int main(int argc, char *argv[]) //C
echo "hello GitHub"#Bash
document.getElementById("myH1").innerHTML="Welcome to my Homepage"; //javascipt
string &operator+(const string& A,const string& B) //cpp

<a name="table"/>显示表格

表头1 表头2
Content Cell Content Cell
Content Cell Content Cell
表头1 表头2
Content Cell Content Cell
Content Cell Content Cell
名字 描述
Help Display the help window.
Close Closes a window

表格中也可以使用普通文本的删除线,斜体等效果

名字 描述
Help Display the help window.
Close Closes a window

表格可以指定对齐方式

左对齐 居中 右对齐
col 3 is some wordy text $1600
col 2 is centered $12
zebra stripes are neat $1

表格中嵌入图片

图片 描述
baidubaidu baidu

<a name="emoji"/>添加表情

Github的Markdown语法支持添加emoji表情,输入不同的符号码(两个冒号包围的字符)可以显示出不同的表情。

比如:blush:,可以显示:blush:。

具体每一个表情的符号码,可以查询GitHub的官方网页http://www.emoji-cheat-sheet.com

但是这个网页每次都打开奇慢。。所以我整理到了本repo中,大家可以直接在此查看emoji

相关文章

  • Markdown语法

    Markdown基本语法 Markdown基本语法1 Markdown基本语法2(全、有用)

  • Markdown 入门指南

    Markdown 入门指南 目录Markdown 语法的起源Markdown 语法的种类Markdown trad...

  • MARKDOWN学习之路3

    MARKDOWN学习之路3 markdown介绍markdown语法标题语法列表语法区块引用语法字体语法分割线图片...

  • 第一次markdown

    #markdown的语法据说很简单 ##markdown的语法据说很简单 ###markdown的语法据说很简单 ...

  • Markdown语法

    Markdown语法 注意: Markdown中使用到的语法符号均为英文符号 Markdown语法主要分为如下几大...

  • 00.markdowm语法

    Link: Markdown 语法说明 . Link: Markdown进阶语法整理 .

  • Markdown语法简要说明

    Markdown语法 注意:Markdown中使用到的语法符号均为英文符号 Markdown语法主要分为如下几大部...

  • Markdown语法使用指南

    Markdown 语法 以下是 Markdown 的常用语法!在以后的笔记中将持续使用 Markdown 语法进行...

  • 基本语法

    语法说明 MarkDown基本介绍及使用 MarkDown语法介绍

  • Markdown语法学习

    Markdown语法学习 目录 Markdown语法学习语法补充Markdown简介基本语法标题分隔线强调链接图片...

网友评论

  • 米酒真香:可惜简书不能给文章添加标签
  • zhaoxuyang:能禁用emoji表情吗? 我不需要两个:之间就转成emoji表情
    光鹏的鹏:使用html实体字符,这样Markdown就不会作为emoji来识别了,& # 5 8 ;(把里面的空格去掉)
  • 果冻虾仁:最近才加入简书,,今天看到了我自己的这篇文章之前就出现在了简书上。。 :joy:
    晴明_:@果冻虾仁 :+1: 手太快 见谅~ :joy:
  • alighters:看上去,简书不支持复选框啊
    c6afa27e7706:TOC也不是官方语法吗?感觉大纲还是挺重要的 可惜我的浏览器(2345)不知道为什么用不了smartTOC=-=
    果冻虾仁:@lighters_wei 复选框不是markdown的官方语法,而是github扩展的markdown语法(Github Flavored Markdown)。
    晴明_:@lighters_wei 嗯 确实不支持

本文标题:Markdown语法

本文链接:https://www.haomeiwen.com/subject/auclhttx.html