Markdown怎么使用

图片链接

如果拷贝了别人的图片插入到自己的博客中，最好在图片上给出一个超链接指向源头，方便追溯出处。 
我们在 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!

脚注（Footnote）

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

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

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

1. 先在需要脚注的单词（terminology）后面添加 [^Footnote] ： terminology[^Footnote]

2. 再在文末 glossary 区域定义脚注（添加注解）： [^Footnote]：explanatory notes

以下是本文针对第二章标题 “标题（Header）”的着色添加的脚注：

## 标题（Header）[^Header]
[^Header]:这里的源码为`标题（Header）`，尝试使用 font.color 着色。123

说明：

1. 被添加脚注的词条后面会出现一个超链接数字（有的渲染为上标格式），点击数字跳转到文末 glossary 区域该脚注的定义处。

2. 文末 glossary 区域该脚注定义的行尾会添加一个回车符号（↵），点击可回到被标注的脚注点。

引用（Blockquote）

HTML 中的 

 标签定义摘自另一个源的块引用。 

 与 

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

Markdown 标记区块引用是使用类似 email 的引用方式，在断好的行前加上 > （more than or greater than sign）：

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

爱上一个人 
恋上一座城

---

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

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

梦

梦中梦

盗梦空间

梦中梦

梦

说明：

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 扩展的基于 YAML 2  标记语言的 Fenced Code Block 引用语法格式。

语法：

• Preformatted Code Block 
在句段的行首插入1个tab 或 4个空格，则表示代码块。

• [Fenced Code Block] 
在句段行首和行末用三个反引号换行闭包，并在行首三个反引号后添加  YAML  语言标识。

language	aliases
Markdown	无别名，注意区分大小写
HTML	xhtml
JavaScript	js、node
C	无别名，注意区分大小写
C++	cpp
Objective-C	obj-c、objc、objectivec
VimL	vim、nvim

示例：

---

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.1234

（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.1234

注意：

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!')1

• 以下演示插入一段 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]));
    }
}12345678910111213141516

注意：

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 '*'123

示例效果：

• 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）123456789101112

---

• 链接（Hyperlink） 

• 书签（Bookmark）

• 脚注（Footnote）

• 插入图片

• 图片链接

• 行内式（Inline）

• 参考式（Reference）

• 自动链接（Autolink）

• 文字（text href） 

• 图片（image href） 

• 锚点（inner link） 

• 引用（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 Hosting3. DESIGNING AND TWEAKING YOUR BLOG  
    Quick and easy ways to get your blog look the way you want4. WRITING BLOG POSTS AND PAGES  
    Adding new content for your Blog (Posts, Pages, Images etc…)12345678

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 done1. [ ] task3 to do2. [x] task4 done1234

---

• [ ] task1 to do

• [x] task2 done 

1. [ ] task3 to do

2. [x] 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Γ(n)=(n−1)!∀n∈N is via the Euler integral

Γ(z)=∫∞tz−1e−tdt.Γ(z)=∫0∞tz−1e−tdt.

书写一个质能守恒公式

E=mc2E=mc2

The end！

---

1. 这里的源码为标题（Header），尝试使用 font.color 着色。  ↩

2. YAML 是”YAML Ain’t a Markup Language”（YAML不是一种置标语言）的递归缩写，早先YAML的意思其实是：”Yet Another Markup Language”（另外一种置标语言）。  ↩

3. LaTeX 是一种基于  ΤΕΧ 的排版系统，它通过\section和\paragraph等语句，规定了每一句话在文章中所从属的层次，从而极大方便了对各个层次批量处理。

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

以上就是关于“Markdown怎么使用”这篇文章的内容，相信大家都有了一定的了解，希望小编分享的内容对大家有帮助，若想了解更多相关的知识内容，请关注创新互联行业资讯频道。


网站题目：Markdown怎么使用
本文地址：http://dzwzjz.com/article/ggjegg.html