notebooks
  • notebooks
  • _planning
    • 2022 OKR
    • basketball
    • swimming
  • communication
    • Dubbo
    • Kafka
    • Messaging
    • RPC
    • Thrift
  • computation
    • map-reduce
  • cs-basic-knowledge
    • computer-architecture
    • data-structure-and-algorithms
    • networks
    • os
  • devops
    • Docker
    • Linux
    • Prometheus
    • operations
    • security
    • trouble-shooting
  • distributed-knowledge
    • Zookeeper_CMD
    • distributed-system
  • game-engine
    • Unity
  • others
    • appium使用
  • protocols
    • http(s)协议
    • 官方链接
    • sip
  • storage
    • Elasticsearch
    • GuavaCache
    • MySQL
    • MySQL_CMD
    • NoSQL
    • Redis
    • Redis_CMD
  • system-design
    • system-design
  • tools
    • Git
    • IDEA
    • Mac
    • VScode
    • Vim
  • _working
    • doc-template
      • backend-design-review
      • correction-of-error
      • service-review
    • process
      • domain-backup
      • oncall
  • blogs
    • history
      • 8088/8086微处理器
      • 8088/8086指令系统
      • CSS-DOM
      • CSS定位
      • CSS工作原理
      • CSS控制背景
      • CSS浮动布局
      • CSS盒模型
      • Chrome开发者工具使用方法
      • DOM
      • Django Model模型层学习
      • Django-REST-framework Serializers学习
      • Django-REST-framework Views和ViewSets学习
      • Django View视图层学习
      • Gvim下Emmet安装及使用教程
      • HTTP协议简介
      • HashMap原理初探
      • JavaScript简史
      • JavaScript语法
      • Java内存模型和GC机制
      • Java基础——Lambda学习
      • Java基础——方法引用
      • Java基础——枚举类型
      • Java类加载机制
      • KMP算法
      • Kafka学习
      • Linux下用命令行编译Java程序
      • MathJax简介和基本用法
      • Python实现常见数据结构
      • Python装饰器总结
      • TCP协议的三次握手和四次挥手
      • Thrift学习
      • asyncio学习
      • markdown的常用语法
      • 修改hosts文件实现翻墙
      • 充实文档的内容
      • 关系数据库
      • 关系数据库标准语言SQL(一)
      • 关系数据库标准语言SQL(二)
      • 关系数据理论
      • 关系查询处理和查询优化
      • 内联元素和块级元素
      • 剑指offer算法题练习
      • 动态创建标记
      • 图形化用户界面
      • 在Eclipse中使用Maven构建Java Web项目
      • 增加微博秀遇到的一些问题
      • 处理机调度
      • 如何用github和hexo搭建个人博客
      • 存储管理
      • 存储系统的层次结构
      • 学习模仿lionhit网站首页的过程总结
      • 实用的GitHub小技巧
      • 并发控制
      • 循环与分支程序设计
      • 指令系统的设计
      • 指令级并行及其开发——硬件方法
      • 搭建自己的VPN服务器
      • 操作系统用户界面
      • 数据库安全性
      • 数据库完整性
      • 数据库恢复技术
      • 数据库绪论
      • 数据库编程
      • 数据库设计
      • 数据抽象
      • 文件系统
      • 文法和语言
      • 最佳实践
      • 案例研究:JavaScript图片库
      • 案例研究:图片库改进版
      • 汇编语言程序格式
      • 汇编语言程序设计基础知识
      • 流水线技术
      • 深度优先搜索和广度优先搜索
      • 牛客网——网易2017秋招编程题集合
      • 用JavaScript实现动画效果
      • 第一篇博客
      • 经典排序算法总结(Java实现)
      • 经典查找算法总结(Java实现)
      • 综合示例
      • 编译原理引论
      • 背包、队列和栈
      • 虚拟机安装Linux系统及常用软件
      • 计算机操作系统绪论
      • 计算机系统结构的基础知识
      • 设备管理
      • 设计模式之代理模式
      • 设计模式之单例模式
      • 设计模式之工厂模式
      • 设计模式之策略模式
      • 设计模式之观察者模式
      • 词法分析
      • 进程管理
      • 闭包
      • 阻止Google自动跳转到香港服务器的方法
      • 项目部署过程
  • programming-language
    • C#
      • C#
    • C&C++
      • C
    • C&C++
      • C++
    • Java
      • GoogleGuice
    • Java
      • JVM
    • Java
      • Java
    • Java
      • Maven
    • Java
      • Mybatis
    • Java
      • Spring知识
    • Java
      • SpringBoot
    • Java
      • Tomcat
    • Python
      • Python
    • Shell
      • Shell
  • wheels
    • dcc
      • 产品调研
      • 方案设计
    • red-envelope
      • 方案设计
    • short-url
      • 短链接服务
    • sso
      • 方案设计
Powered by GitBook
On this page
  • 导语
  • 常用语法
  • 遇到的问题
  1. blogs
  2. history

markdown的常用语法

Previousasyncio学习Next修改hosts文件实现翻墙

Last updated 3 years ago

导语

是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。

常用语法

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

标题

Markdown支持两种标题的语法,类Setext和类atx形式。 类Setext形式使用底线的形式,利用=(最高阶标题)和-(第二阶标题),例如:

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

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

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

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

区块引用

> 这里是引用内容
> 这里是引用内容

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

> 这里是引用内容
这里是引用内容...

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :

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

注意返回上一级引用的写法 引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。

列表

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

* red
* green
* blue

+ red
+ green
+ blue

- red
- green
- blue

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

1. bird
2. mchale
3. parish

很重要的一点是,你在列表标记上使用的数字并不会影响输出的 HTML 结果

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

* Bird
* Magic

转换为:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>


* Bird

* Magic

转换为:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

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

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.

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

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

代码区块

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

这是一个普通段落:

    这是一个代码区块。

注意要有空行

分隔线

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

* * *

***

*****

- - -

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

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。 行内式:

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

See my [About](/about/) page for details.    //相对路径

参考式:

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

//接着,在文件的任意处,你可以把这个标记的链接内容定义出来
[id]: http://example.com/  "Optional Title Here"

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号:

*text*    //斜体
**text**    //加粗
***text***    //加粗和斜体

代码

一小段代码:

`text`
``text``

大段代码:

```text```

### 图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式:
`![alt text](path)`
参考式:
`![alt text][id]`
`[id]:path`
**建议使用[七牛云](http://www.qiniu.com/)作为图床。上传网站图片到七牛云,生成外链,然后复制到文档中。**
### 表格
操作对象
创建
删除
修改

模式

CREATE SCHEMA

DROP SCHEMA

表

CREATE TABLE

DROP TABLE

ALTER TABLE

视图

CREATE VIEW

DROP VIEW

索引

CREATE INDEX

DROP INDEX

ALTER INDEX

```

效果为:

操作对象
创建
删除
修改

模式

CREATE SCHEMA

DROP SCHEMA

表

CREATE TABLE

DROP TABLE

ALTER TABLE

视图

CREATE VIEW

DROP VIEW

索引

CREATE INDEX

DROP INDEX

ALTER INDEX

```

操作对象

创建

删除

修改

--------

:-------------:

:-----------

-----------:

模式

CREATE SCHEMA

DROP SCHEMA

表

CREATE TABLE

DROP TABLE

ALTER TABLE

视图

CREATE VIEW

DROP VIEW

索引

CREATE INDEX

DROP INDEX

ALTER INDEX

```

效果为:

操作对象
创建
删除
修改

模式

CREATE SCHEMA

DROP SCHEMA

表

CREATE TABLE

DROP TABLE

ALTER TABLE

视图

CREATE VIEW

DROP VIEW

索引

CREATE INDEX

DROP INDEX

ALTER INDEX

## Markdown免费编辑器

Windows平台

Linux平台

Mac平台

在线编辑器

浏览器插件

遇到的问题

Q:列表下面的段落会缩进 在列表后加一段空行

Q:如何插入html标签 需要用到转义字符。例如插入<head>标签,写成&lt;head&gt;。

(Chrome)

Markdown
GitHub Atom
MarkdownPad
MarkPad
ReText
Mou
Markable.in
Dillinger.io
Cmd Markdown
MaDe