Markdown基础语法整理

* 更新说明

2015.11.14更新

  • 在区段元素的强调栏增加删除线和空格的标记方法
  • 将表格、流程图和时序图等不常用的语法移至Markdown进阶语法整理

关于Markdown

Markdown是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。

锤子科技15年8月发布会上,老罗宣布锤子便签支持Markdown语法。我们可大胆预测,使用Markdown语法在移动端编辑会逐渐成为趋势。

优点

  • 简单标记符完成排版,所写即所见,让你专注于文字而不是排版
  • 纯文本,所以兼容性极强,可以用所有文本编辑器打开
  • 格式转换方便,Markdown文本可以轻松转换为 html、pdf等
  • Markdown 的标记语法有极好的可读性

Markdown简单语法示例


主要分为区块元素和区段元素。

区块元素


1.段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。

2.标题

用#标识符表示,例如:

Paste_Image.png
3.区块引用
  • 在段落的第一行最前面加">"


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


    Paste_Image.png
  • 区块内也可以套用其他的 Markdown 语法,包括加粗、列表、代码区块等:


    Paste_Image.png
4.列表

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

  • 无序列表使用星号、加号或是减号作为列表标记,效果一样:


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


    Paste_Image.png
5.代码区块

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:

Paste_Image.png
6.分隔线

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

   ***
   ---
   * * *

区段元素

1.链接

方块括号后面紧接着圆括号并插入网址链接即可,例如:
我的博客地址:Mr H's Blog

,
2.强调

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

  • 斜体
Paste_Image.png
  • 粗体
Paste_Image.png
  • 删除线
  • 空格

Markdown语法会忽略首行开头的空格,如果要体现出首行开头空两个的效果,可以使用 全角符号下的空格 ,windows下使用 shift+空格 切换。

Paste_Image.png
3.行内标记

行内标记用反引号把它包起来' ',例如:

Paste_Image.png
4.插入图片

我用过的简书在线编辑器和马克飞象都支持直接导入本地图片和从粘贴板粘贴,就像酱紫:

Paste_Image.png

其他

1.反斜杠

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:

Paste_Image.png
2.自动邮箱链接

Markdown支持以比较简短的自动链接形式来处理电子邮件信箱,例如:
给我发邮件,欢迎骚扰h_xuetao@163.com

Paste_Image.png

Markdown编辑器


市面上Markdown编辑器很多,功能都比较齐全,差别不大。有的界面好一些;有的浏览器客户端全平台支持;有的可以下载各种格式文档;有的收费,有的免费;最主要还是要看什么适合自己,适合自己的才是最好的。

我是先用的是简书的Markdown在线编辑器。然后复制粘贴到马克飞象Markdown编辑器导出.md和pdf文档。

参考


http://www.markdown.cn/#overview
http://www.jianshu.com/p/q81RER
http://www.jianshu.com/p/197fb4f0b94c

本文持续更新

推荐阅读更多精彩内容

  • 学习Markdown。 本篇文章内容 标题写法 列表 引用 超链接 插入图片 各种文字效果与分割线 代码格式 补充...
    wxkkkkk阅读 517评论 1 7
  • << 访问 Wow!Ubuntu NOTE: This is Simplelified Chinese Edit...
    fisher爱吃鱼阅读 5,988评论 0 71
  • Markdown 语法说明 (简体中文版) 概述宗旨兼容 HTML特殊字符自动转换 区块元素段落和换行标题区块引用...
    蚊子Skeeter阅读 2,491评论 3 12
  • << 访问 Wow!Ubuntu NOTE: This is Simplelified Chinese Edit...
    临城阅读 6,087评论 4 44
  • 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色。此文档用 Mar...
    Cellei阅读 4,179评论 0 22