Markdown基础教程

文章目录

    • 注释(Comment)
    • 标题(Header)[^Header]
      • Setext Heading Format(2 level)
      • Atx Heading Format(6 level)
    • 句段(Sentence / Paragraph)
      • 换行
        • br
      • 分段
    • 符号(Punctuation Characters)
      • 转义字符
      • 字符实体
    • 分隔线(Horizontal Rules)
    • 文本格式(Text Styling)
      • 强调(Italic/Emphasize)
      • 加粗(Bold/Strong)
      • 突出(Mark/Highlight)
      • 下划线(Underline)
      • 删除线(Strikethrough)
      • 脚标(Script)
        • 上脚标
        • 下脚标
    • 链接(Hyperlink)
      • 自动链接(Autolink)
      • 文字(text href)
        • 行内式(Inline)
        • 参考式(Reference)
      • 图片(image href)
        • 插入图片
        • 图片链接
      • 锚点(inner link)
        • 书签(Bookmark)
        • 脚注(Footnote)
    • 引用(Blockquote)
    • 代码(Code)
      • 行内代码(Inline Code)
      • 代码块(Code Blocks)
    • 列表(List)
      • 无序列表(Unordered List)
      • 有序列表(Ordered List)
      • 任务列表(Task Lit)
    • 表格(Table)
    • 数学公式

注释(Comment)

注释是写作者自己的标注记录,不被浏览器解析渲染。
HTML 以 结尾的闭包定义注释(支持跨行),不在正文中显示。
Markdown 沿用 HTML Comment 注释格式:

注释适用场景示例:

  1. CSDN 博客默认会在网页生成TOC,而 GitHub 仍不支持[TOC],因此在发布 Markdown 博客时可在开头以 注释掉 [TOC] 标签,在支持 TOC 标签渲染时再打开。

  2. 在博客 Markdown 源码开头,本人通常使用注释来备注 git commit-hash-id 和 commit-date 信息(git log -p ),以便修订变更时回溯。


  1. 在使用 Markdown 写作博客时,本人喜欢采用参考式链接,然后在文末专门开辟一节用于定义文中用到的所有脚注和参考链接。借助 Haroopad/FoldingText/Marked2 的折叠特性,本人习惯在末尾添加一行 Comment Heading,用于在阅读 Markdown 源码时折叠隐藏文末的参考区。

##

标题(Header)1

标题用于呈现文档组织结构,很多 Markdown 解析器都提供基于 Heading Levels 来生成文档大纲的 [TOC](Table of Contents)标签,搜索引擎则使用标题为网页的结构和内容编制索引。
一般论文或博客文档结构到3到4级即可,可参考《毕业论文的国家标准格式与通用格式》、《发表论文通用格式》和《期刊论文格式》。

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

Setext Heading Format(2 level)

类 Setext 形式是用底线的形式,使用三个或以上连续 =(equal signs)底线标记最高阶标题,使用三个或以上连续 -(dashes)底线标记第二阶标题。例如:

  1. equal signs for first-level headers:
	This is an H1
	===
  1. dashes for second-level headers:
	This is an H2
	----

Atx Heading Format(6 level)

类 Atx 形式则是在行首插入 1 到 6 个 # (hash character),对应 6 阶标题(对应 HTML 中的

-
标签)。例如:

# 这是一级标题(H1,通常用于文档标题)  
## 这是二级标题(H2,有些渲染器会为二级标题添加 hr 底线)  
### 这是三级标题(H3)  
#### 这是四级标题(H4)  
##### 这是五级标题(H5)#####  
###### 这是六级标题(H6)######

行首的 # 号个数决定标题阶数,为兼容和阅感起见,建议最后一个 # 号和标题之间加插一个空格。
行中(末)的 # 号则被视作普通字符。为美观起见,也可以选择性地「闭合」类 atx 样式的标题,在行尾加上对应或不限数量的 # 号。

句段(Sentence / Paragraph)

换行

标准 Markdown 不支持自然换行(literal new line),有些渲染器扩展支持自然换行。
# 号标识的 Heading(H1-H6) 会自然换行,普通句段之间若要强制换行(Manual Line Break),可以在自然换行行尾追加两个(或以上)空格来实现。

由于不同的 Markdown Editor 的渲染效果不一,建议按照标准 Markdown 书写,这样发布到不同的渲染引擎下才能取得最优的兼容性。
例如:你可能需要在两行连续的以 > 开头的引用之间加入两个空格硬换行来避免粘连;在某些 Markdown Editor 中,你可能需要在列表项行尾追加两个空格硬换行来续接后面的混合编排。

br

由于空格在 Markdown 中主要是起着控制排版的作用,因此在某些复杂的区块元素中,例如下文提到的 Table 表格中的 td 元素中,可通过内嵌 HTML 的
(XHTML 自闭合写作
)标签来实现局部换行。

分段

段落是由一个或多个连续的文本行组成,它的前后往往需要空行予以明示分隔。

在显示上看起来像是空的,例如只包含空格或(和)制表符(tab)的行,便会被视为空行。

空行适用场景说明:

  1. 空行的上一句末无需再添加两个空格或
    换行了。
  2. 句段之间引入空行,相当于间隔成段落(对应 HTML 的

    标签)。

  3. 尽管 Markdown Render 会对各阶 Heading(H1-H6)有特殊的格式渲染来凸显层级,但还是建议在标题下一行和章节(Section/Chapter)末尾适时插入空行,以示行文分割且方便阅读。
  4. 为了更优的 阅读感兼容性,建议在分割线(Horizontal Rules)的上面留一空行,块引用(Blockquote)、预格式化(Preformatted Code Block)、列表(List)、表格(Table)等区块元素的上下各插入空行。

符号(Punctuation Characters)

转义字符

Markdown 精挑细选了一些符号组成了一套基于文本的标记语法。比如:

  • 在文字两旁加上 * 或 ** 号,表意 *突出*、**强调**。
  • 多行行首添加 -(+, *)号,看起来就是列表。
  • 句段行首添加 > 号来表示引用区块,就像你曾在电子邮件中见过的那样。

可以使用反斜杠(\,backslash)转义输入原义字符,避免当做 Markdown 的标记符号渲染。

#:行首的 #(此处使用 kbd 闭包显示按键字母)号默认为H1,这里使用反斜杠转义显示原义字符,否则会被渲染为一级标题。

字符实体

在 Markdown 中,空格和 tab 往往用于格式控制,例如:

  • 行首插入 tab 或 四个空格 缩进表示
     预格式化;
  • 引用、列表的 bullet 标记符前的 tab 或 空格 用于缩进嵌套层级;

普通段落一般都是顶格开始,无法使用 空格 或 tab 来缩进,包括引用标记符(>)、列表标记符(bullet list indicator)后面的空格都无法实现缩进。
如果硬要输入空格显示占位缩进效果,可以嵌入空格对应的 HTML Entity 实体码。HTML 转义字符串(Escape Sequence),即字符实体(Character Entity)。

字符实体由三部分构成:

  1. 第一部分是一个 & (ampersand)符号;
  2. 第二部分是实体(Entity)名字;或者 # 加上实体编号(Entity Code);
  3. 第三部分是一个分号 ; (semicolon)。

HTML提供了5种空格实体(space entity),它们拥有不同的宽度。
非断行空格( )是常规空格的宽度,可运行于所有主流浏览器;其他几种空格( )在不同浏览器中宽度各异。

entity code full-name width
    no-break space 键盘空格(space bar)
en space 半角空格(half-width)
em space 全角空格(full-width)
  1. 在HTML中,使用 产生的空格是不会累加的(只算1个);要使用html实体表示才可累加。
  2. 中的 en 是字体排印学的计量单位,为 em 宽度的一半,名义上是小写字母n的宽度。此空格传承空格家族一贯的特性:透明的!此空格有个相当稳健的特性,就是其占据的宽度正好是1/2个中文宽度,而且基本上不受字体影响。
  3. 中的 em 是字体排印学的计量单位,相当于当前指定的点数。此空格也传承空格家族一贯的特性:透明的!此空格也有个相当稳健的特性,就是其占据的宽度正好是1个中文宽度,而且基本上不受字体影响。

普通自然行行首敲2个空格无占位缩进效果。
    该行行首添加了4个 
    该行行首添加了4个
    该行行首添加了4个

分隔线(Horizontal Rules)

你可以在一行中用三个以上的星号(asterisks:*)或减号(hyphens:-)或底线(underscores:_)来建立一个水平分隔线,对应 HTML 中的


标签,用于 Sentence/Section/Page Break。
行内不能有其他东西,但你可以在星号或是减号中间插入空格。

下面每种写法都可以创建分隔线:

	---
	- - -
	-----

注意:采用减号(-)分割时,最好空格隔开或上面空一行,不然三个以上连续的减号会误将上一行文字升级为二级标题!

文本格式(Text Styling)

文本格式包括强调、加粗、突出、下划线、删除线、脚标等增强修饰和丰富表现。

强调(Italic/Emphasize)

说明:

星号(*)或下划线(_)包围的文字将会显示斜体,对应 HTML 中的 / 标签。

语法:

Some of these words *are emphasized*.
Some of these words _are emphasized also_.

示例:

Some of these words are emphasized.
Some of these words are emphasized also.

GFM(Github Flavored Markdown)建议:

鉴于C语言等源码中,通常采用下划线定义变量,因此 GFM 忽略单词内的下划线,同时建议使用星号(*)来闭包标记斜体。

下划线闭包单词斜体:wow great stuff (源码:wow _great_ stuff)
GFM 忽略单词内的下划线:wow_great_stuff

加粗(Bold/Strong)

说明:

两个星号(**)或下划线(__)包围的需要特别强调的文字将会加粗显示,对应 HTML 中的 / 标签。

语法:

Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.
A ***section surrounded with three asterisks*** will be  specially emphasized.

示例:

Use two asterisks for strong emphasis.
Or, if you prefer, use two underscores instead.
A section surrounded with three asterisks will be specially emphasized.

突出(Mark/Highlight)

说明:

在 HTML 中,可以使用 标签来高亮显示文字,以达到醒目的目的。
标准 markdown 没有提供对应的标签支持,Macdown 和 Haroopad 均使用两个等号(equal signs:=)包围来突出高亮显示。

语法:

Macdown 和 Haroopad:==Highlight==
CriticMarkup语法:{==Highlight==}
HTML:Highlight

示例:

Macdown 和 Haroopad:Highlight
HTML:Highlight

下划线(Underline)

说明:

在 HTML 中,可以使用 标签来为文本添加下划线。
标准 markdown 没有提供对应的标签支持,MMD(MultiMarkdown)提供了扩展支持。
Macdown 使用星号表示强调,使用下划线表示下划线原义;Haroopad 则使用两个加号(plus sign:+)来标记下划线。

语法:

Macdown:_underline_
Haroopad:++underline++
HTML:underline

示例:

Macdown:underline
Haroopad:++underline++
HTML:underline

删除线(Strikethrough)

说明:

在 HTML 中,可以使用 标签来定义文档中已被删除的文本(配合 标签来描述文档中的更新和修正)。
标准 markdown 没有提供对应的标签支持,GFM 提供了扩展支持,使用两个波浪符号(two wavy line:~~)包围来给文本添加删除线。

语法:

~~Strikethrough~~

示例:

Strikethrough

脚标(Script)

标准 Markdown 不支持脚标,只能通过内嵌 HTML 的标签来实现。

上脚标

Haroopad 语法(Caret):^Superscript^
HTML 语法:superscript

示例:

2^10^ = 210 = 1024;

下脚标

Haroopad 语法:~Subscript~
HTML 语法:subscript

示例:

H~2~O = H2O is a liquid.

链接(Hyperlink)

自动链接(Autolink)

当我们在书写一个网址时,有些 Markdown Render 能自动生成标题(title)与网址(href URL)一致的链接,这种链接也即自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要用尖括号包起来的文字, Markdown 就会自动识别转化成链接。
对于 HTTP(s) 协议开头的超链接地址,甚至无需添加尖括号明示,也会生成自动链接。

http://daringfireball.net/projects/markdown/

文字(text href)

Markdown 支持两种形式的超文本链接语法格式: 行内式(Inline)和参考式(Reference)两种形式。
不管是哪一种,链接文字都是用方括号(square brackets:[])来标记。

行内式(Inline)

只要在方块括号后面紧接着圆括号(parenthesis or round brackets)并插入链接网址即可在一行内构建链接,其语法格式为[text](url),HTML 等效源码为 text
如果是要链接到本机资源,可以使用相对路径(./path/to/your/resource)。


以下定义了一个指向 Daring Fireball Markdown 首页的超链接:

[Daring Fireball Markdown](http://daringfireball.net/projects/markdown/)

Daring Fireball Markdown

如果你还想要加上链接的 title ,只要在网址后面用双引号把 title 文字包起来即可。

[Daring Fireball Markdown](http://daringfireball.net/projects/markdown/ "Markdown Official Website")

Daring Fireball Markdown

当鼠标悬停在超链接文本上时,将会提示 “Markdown Official Website”。

参考式(Reference)

参考式的链接是在链接文字的括号后面再接上另一个方括号,在第二个方括号里面填入用以辨识链接的标记id,然后在其他地方给出该标记id真正的链接地址。

  1. 先定义参考refid:[text][refid]
  2. 再定义refid所指:[refid]:URL

以下参考间接定义指向 Daring Fireball Markdown 首页的超链接:

  1. 先定义参考id为markdown_homepage_refid:
    [Daring Fireball Markdown][markdown_homepage_refid]
  2. 再在其他地方定义markdown_homepage_refid指向的URL:
    [markdown_homepage_refid]:http://daringfireball.net/projects/markdown/
  3. 最终效果同行内式:

Daring Fireball Markdown

说明:

  1. 也可选择性地在两个方括号中间加上一个空格:[text] [refid]。由于 Markdown 不支持自然换行,将两个方括号在连续两行书写也是没问题的。中间用空行隔开,则被认为是两条精简格式的参考链接。
  2. refid 可以与 text 一致,从而进一步精简参考链接的书写格式:
    • 此时 [refid] 中的 refid 可以省略置空为 [] :先定义 [text][] ,再定义 [text]:URL
    • 你甚至可以将 [text][] 中的空中括号也省掉不写,进一步简写为 [text] ,后面再定义 [text]:URL
  3. refid 所指 href URL 在文件任意处给出定义即可。[refid]:URL 的 URL 后面可以选择性地用单引号、双引号或是括弧闭包起来标记 title。
    下面这三种链接的定义都是相同的:
    [foo]: http://example.com/ "Optional Title Here"
    [foo]: http://example.com/ 'Optional Title Here'
    [foo]: http://example.com/ (Optional Title Here)

图片(image href)

插入图片

Markdown 使用一种和文本链接很相似的语法来插入图片,同样也允许两种样式: 行内式和参考式。
不同的是,需要在链接文字方括号之前添加一个感叹号(exclamation mark:!),其语法格式为 ![alt_text](url),HTML 等效源码为 text,其中alt_text可以置空。

daringfirefall logo:

![daringfirefall](http://daringfireball.net/graphics/logos/)

Markdown基础教程_第1张图片

当然,你也可以像文字链接那样添加 title 以供鼠标悬停提示。

说明:

Markdown 中的段落(包括图片)默认顶格左对齐,若要将图片居中,可以直接内嵌 HTML 的 标签,设置align="middle"。如果还不行,可以尝试封裹一层 div 设置 style="text-align:center" 实现:

程序猿-弦苦
Markdown基础教程_第2张图片

图片链接

如果拷贝了别人的图片插入到自己的博客中,最好在图片上给出一个超链接指向源头,方便追溯出处。
我们在 Markdown 图片标记![]()外面再嵌套一层[]()即可建立图片超链接,点击图片即可跳转到链接源地址。
图片链接的格式看起来大概是这样的:
[![](img_url)](ref_url)

定义 haroopad logo 指向首页:

[![](http://pad.haroopress.com/assets/images/logo-small.png "haroopad")](http://pad.haroopress.com/)

锚点(inner link)

书签(Bookmark)

HTML 中的 标签最重要的属性是 href ,它指示的链接目标,既可以是外部站点,也可以是页内锚点。页内锚点可以实现类似书签跳转的功能,最典型的就是点击 TOC 中的目录书签跳转到指定章节阅读。

构建页内锚点的语法,类似参考式链接:

  1. 先定义锚点id:bookmark_text
  2. 再定义一个id为auchor_id的对象(这里以

    为例):

    auchor_text

例如,我们在文末定义了id为end的 EOF(End Of File):

The end!

,然后通过Goto the End!指定书签“Goto the End!”跳转到文末“The End!”处:

Goto the End!

脚注(Footnote)

上面我们定义了书签 Goto the End! ,点击该书签将跳转到文末 id 为 #end 的锚点,使得我们能快速翻到文末。那怎么再跳转回刚才书签所在的阅读点呢?下面来介绍一下具备回环跳转效果的脚注。

脚注用于为正文中的某个条目添加补充注释,对词条的引文出处进行标注或对专业术语予以解释,跟参考文献一样。脚注一般位于文档的末尾,文内则以数字标注。

脚注的写法和极简参考式链接书写格式比较类似:

  1. 先在需要脚注的单词(terminology)后面添加 [^Footnote]terminology[^Footnote]
  2. 再在文末 glossary 区域定义脚注(添加注解): [^Footnote]:explanatory notes

以下是本文针对第二章标题 “标题(Header)”的着色添加的脚注:

## 标题(Header)[^Header]

[^Header]:这里的源码为`标题(Header)`,尝试使用 font.color 着色。

说明:

  1. 被添加脚注的词条后面会出现一个超链接数字(有的渲染为上标格式),点击数字跳转到文末 glossary 区域该脚注的定义处。
  2. 文末 glossary 区域该脚注定义的行尾会添加一个回车符号(↵),点击可回到被标注的脚注点。

引用(Blockquote)

HTML 中的

标签定义摘自另一个源的块引用。
之间的所有文本都会从常规文本中分离出来,经常会在左右两边进行缩进,而且有时会使用斜体。也就是说,块引用拥有它们自己的空间。本文大量使用引用(复合列表)来标识特殊说明或注意事项。

Markdown 标记区块引用是使用类似 email 的引用方式,在断好的行前加上 > (more than or greater than sign):

> 爱上一个人  
> 恋上一座城

爱上一个人
恋上一座城

行首的多重引用标记可以实现嵌套缩进效果(注意解梦时需要空行出梦):

> 梦
>> 梦中梦
>>> 盗梦空间
>
>> 梦中梦

> 梦

实际效果:

梦中梦

盗梦空间

梦中梦

说明:

  1. 若使用引用格式插入代码,行首的缩进格式丢失,需要自行补充空格占位符。
  2. 一般不建议使用 blockquote(>)格式引用源代码,应采用 pre 格式引用代码块。
  3. 嵌套深入浅出时,需要适当添加空行(blank line)或者空引用行(additional levels of >)。

代码(Code)

如果要标记行内代码片段,可以用反引号(backtick quotes)闭包;如果要插入跨行片段或块,可使用预格式化语法。
本文在示范 Markdown 语法源码时,独行单句采用了行内代码格式,跨行代码片段则采用了代码块格式。

行内代码(Inline Code)

说明:

如果要标记行内代码片段,可以用反引号(backtick quotes)包裹,对应 HTML 中的 标签(把文本变成等宽字体,暗示是源程序代码)。
如果要在代码区段内插入反引号,可以用多个反引号来开启和结束代码区段。

语法:

Use the `printf()` function.(此处使用了反斜杠转义)

示例:

Use the printf() function.(`printf()`)
Use the`printf()`function.(`` `printf()` ```)

代码块(Code Blocks)

说明:

  • Preformatted Code Block
    如果要插入跨行片段或块,且要保持排版样式(包括空格、换行符和缩进),可使用预格式化引用语法格式。对应 HTML 中的
     标签。
  • Fenced Code Block
    如果要支持编程语言语法高亮,则可以使用 GFM 扩展的基于 YAML2 标记语言的 Fenced Code Block 引用语法格式。

语法:

  • Preformatted Code Block
    在句段的行首插入1个tab 或 4个空格,则表示代码块。
  • [Fenced Code Block]
    在句段行首和行末用三个反引号换行闭包,并在行首三个反引号后添加 YAML 语言标识。
language aliases
Markdown 无别名,注意区分大小写
HTML xhtml
JavaScript jsnode
C 无别名,注意区分大小写
C++ cpp
Objective-C obj-cobjcobjectivec
VimL vimnvim

示例:

1.Preformatted Code Block

将一段代码块整体向右缩进(⌘ + ])即可测试。

(1)以tab开头:

these lines begin with tab will be shown as pre code block.
these lines begin with tab will be shown as pre code block.
these lines begin with tab will be shown as pre code block.

(2)以4个空格开头:

these lines begin with 4 spaces will also be shown as pre code block.
these lines begin with 4 spaces will also be shown as pre code block.
these lines begin with 4 spaces will also be shown as pre code block.

注意:

pre 格式存在以下缺陷:

  • 对多tab及空格的缩进支持不完善!
  • 将宏符号#(#include、#import)误解为H1,可能会影响解析器的TOC!
  • 将顶格空白行(包括行首带tab)误认为Paragraph Break,而割断代码块成片段!

2.Fenced Code Block

Fenced Code Block 以三个反引号(backtick quotes:`,有的支持波浪线~)包裹,第一行的三个反引号之后可以冠上编程语言的 YAML 标记识别语法高亮。

  • 以下演示插入一句 python 代码:

首行(三个反引号开头):```python
中间:print(‘Hello world!’)
末行(三个反引号结尾):```

print('Hello world!')
  • 以下演示插入一段 Objective-C 代码:

首行:```obj-c
中间:Objective-C Code Block
末行:```

//
//  main.m
//  EmptyApplication
//
//  Created by faner on 15/9/5.
//  Copyright © 2015年 faner. All rights reserved.
//

#import 
#import "AppDelegate.h"

int main(int argc, char * argv[]) {
	@autoreleasepool {
		return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
	}
}

注意:

  1. Haroopad 编辑器将上述代码中的#import的第一个有效字符#误解为 H1,导致 TOC 错乱或 Heading Focus Folding 失效。此时,可尝试在 Fenced Code Block 行首添加空格或 tab 缩进。
  2. 关于 GitHub 配置 Fenced Code Block 语法高亮所使用的 YAML 标记 ,可参考 初探YAML、YAML学习、YAML学习总结、YAML–想要爱你很容易。

列表(List)

GFM 等 Markdown 扩展支持和无序列表、有序列表和任务列表。

无序列表(Unordered List)

无序列表(unordered, bulleted)项目的行首使用星号(或加号,或减号)加空格作为列表标记(list markers):

- bullet list item 1 begin with a hyphens '-'
+ bullet list item 2 begin with a pluses '+'
* bullet list item 3 begin with an asterisks '*'

示例效果:

  • bullet list item 1 begin with a ‘-’
  • bullet list item 2 begin with a ‘+’
  • bullet list item 3 begin with a ‘*’

通过在列表标记前面增加 tab 阶次来实现嵌套效果(nested list)。
以下是针对本文 TOC 中【链接】这一章节的目录:

- 链接(Hyperlink)
	- 自动链接(Autolink) 
	- 文字(text href)
		- 行内式(Inline) 
		- 参考式(Reference)
	- 图片(image href)
		- 插入图片
		- 图片链接
	- 锚点(inner link)
		- 书签(Bookmark)
		- 脚注(Footnote)
- 引用(Blockquote)

效果如下:

  • 链接(Hyperlink)
    • 自动链接(Autolink)
    • 文字(text href)
      • 行内式(Inline)
      • 参考式(Reference)
    • 图片(image href)
      • 插入图片
      • 图片链接
    • 锚点(inner link)
      • 书签(Bookmark)
      • 脚注(Footnote)
  • 引用(Blockquote)

缩进控制符:空格 or TAB?

  1. 在列表标记前面插入空格也可以实现缩进控制嵌套效果,但不同的 Markdown Render 对控制层级的空格个数要求不一。
  2. 为了取得最佳的兼容性,建议使用 tab 来控制嵌套层级(nested hierarchy),以期在不同的渲染引擎下都能达到预期的显示效果。当然,前提是使用 hard tabs(tab characters),而非 soft tabs(spaces)。

有序列表(Ordered List)

有序列表(ordered / numbered)项目的行首则使用数字接一个英文句点标记(use numbers followed by periods):

1. GETTING STARTED  
	Choosing Blogging Platform (WordPress)
2. GETTING YOUR BLOG ONLINE  
	Choosing Domain Name & Web Hosting
3. DESIGNING AND TWEAKING YOUR BLOG  
	Quick and easy ways to get your blog look the way you want
4. WRITING BLOG POSTS AND PAGES  
	Adding new content for your Blog (Posts, Pages, Images etc…)

Step-by-step walkthrough for starting a blog:

  1. GETTING STARTED
    Choosing Blogging Platform (WordPress)
  2. GETTING YOUR BLOG ONLINE
    Choosing Domain Name & Web Hosting
  3. DESIGNING AND TWEAKING YOUR BLOG
    Quick and easy ways to get your blog look the way you want
  4. WRITING BLOG POSTS AND PAGES
    Adding new content for your Blog (Posts, Pages, Images etc…)

有序列表和无序列表可以实现混合嵌套编排。

任务列表(Task Lit)

GFM 扩展支持把列表变成带勾选框的任务列表,只需要在列表标记后添加[ ]标记☐表示unchecked,在中括号中填写x([x])标记☑︎表示checked(filled)。

- [ ] task1 to do
- [x] task2 done
1. [ ] task3 to do
2. [x] task4 done

  • task1 to do
  • task2 done
  1. task3 to do
  2. task4 done

表格(Table)

You can create tables by assembling a list of words and dividing them with hyphens - (for the first row), and then separating each column with a pipe | (vertical bar):

First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

For aesthetic purposes, you can also add extra pipes on the ends:

First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

Note that the dashes at the top don’t need to match the length of the header text exactly:

Name Description
Help Display the help window.
Close Closes a window

You can also include inline Markdown such as links, bold, italics, or strikethrough:

Name Description
Help Display the help window.
Close Closes a window

Finally, by including colons : within the header row, you can define text to be left-aligned, right-aligned, or center-aligned:

Left-Aligned Center Aligned Right Aligned
col 3 is some wordy text $1600
col 2 is centered $12
zebra stripes are neat $1

A colon on the left-most side indicates a left-aligned column; a colon on the right-most side indicates a right-aligned column; a colon on both sides indicates a center-aligned column.

数学公式

You can render LaTeX3 mathematical expressions using MathJax4, as on math.stackexchange.com:
The Gamma function satisfying Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n1)!nN is via the Euler integral

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t   . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=0tz1etdt.

书写一个质能守恒公式

E = m c 2 E=mc^2 E=mc2

可参考 Mathjax与LaTex公式简介。

##

The end!


  1. 这里的源码为标题(Header),尝试使用 font.color 着色。 ↩︎

  2. YAML是"YAML Ain’t a Markup Language"(YAML不是一种置标语言)的递归缩写,早先YAML的意思其实是:“Yet Another Markup Language”(另外一种置标语言)。 ↩︎

  3. LaTeX是一种基于 ΤΕΧ的排版系统,它通过\section和\paragraph等语句,规定了每一句话在文章中所从属的层次,从而极大方便了对各个层次批量处理。可参考 TeX 与 LaTeX、LaTeX 入门文档 和 LaTeX 入门教程。 ↩︎

  4. MatchJax 是一个JavaScript引擎,用来显示网络上的数学公式。MathJax可以解析Latex、MathML和ASCIIMathML的标记语言。 ↩︎

你可能感兴趣的:(编程工具&生产效率)