我的编程空间,编程开发者的网络收藏夹
学习永远不晚

Markdown怎么使用

短信预约 -IT技能 免费直播动态提醒
省份

北京

  • 北京
  • 上海
  • 天津
  • 重庆
  • 河北
  • 山东
  • 辽宁
  • 黑龙江
  • 吉林
  • 甘肃
  • 青海
  • 河南
  • 江苏
  • 湖北
  • 湖南
  • 江西
  • 浙江
  • 广东
  • 云南
  • 福建
  • 海南
  • 山西
  • 四川
  • 陕西
  • 贵州
  • 安徽
  • 广西
  • 内蒙
  • 西藏
  • 新疆
  • 宁夏
  • 兵团
手机号立即预约

请填写图片验证码后获取短信验证码

看不清楚,换张图片

免费获取短信验证码

Markdown怎么使用

这篇“Markdown怎么使用”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“Markdown怎么使用”文章吧。

HTML 以 <!-- 开头,以 --> 结尾的闭包定义注释(支持跨行),不在正文中显示。 
Markdown 沿用 HTML Comment 注释格式: 
<!-- This text will not appear in the browser window. --> 

注释适用场景示例:

  1. CSDN 博客默认会在网页生成TOC,而 GitHub 仍不支持[TOC],因此在发布 Markdown 博客时可注释掉开头的 [TOC] 标签,在需要查看 OUTLINE 时再打开。 
    <!--[TOC]-->

  2. 在博客 Markdown 源码开头,本人通常使用注释来备注 git commit-hash-id 和 commit-date 信息(git log -p ),以便修订变更时回溯。 
    <!--commit 5326f29752b7ee3472aa00b40574bd585e3ef25b--> 
    <!--Mon Nov 2 00:36:40 2015 +0800-->

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

标题(Header)1

标题用于呈现文档组织结构,很多 Markdown 解析器都提供基于 Heading Levels 来生成文档大纲的 [TOC](Table of Contents)标签,搜索引擎则使用标题为网页的结构和内容编制索引。 

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

Setext Heading Format(2 level)

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

  1. equal signs for first-level headers:

    This is an H1    ===12
  1. dashes for second-level headers:

    This is an H2    ----12

Atx Heading Format(6 level)

类 Atx 形式则是在行首插入 1 到 6 个 # (hash character),对应 6 阶标题(对应 HTML 中的 <h2> - <h7> 标签)。例如:

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

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

句段(Sentence / Paragraph)

换行

标准 Markdown 不支持自然换行(literal new line),有些渲染器扩展支持自然换行。 
# 号标识的 Heading(H1-H6) 会自然换行,普通句段之间若要强制换行(Manual Line Break),可以在自然换行行尾追加两个(或以上)空格来实现。 
由于不同的 Markdown Editor 的渲染效果不一,建议按照标准 Markdown 书写,这样发布到不同的渲染引擎下才能取得最优的兼容性。例如:你可能需要在两行连续的以 > 开头的引用之间加入两个空格硬换行来避免粘连;在某些 Markdown Editor 中,你可能需要在 bullet list item 行尾追加两个空格硬换行来续接后面的混合编排。

适时内嵌 HTML 的 <br> 控制换行

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

分段

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

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

空行适用场景说明:

  1. 空行的上一句末无需再添加两个空格或 <br/> 换行了。

  2. 句段之间引入空行,相当于间隔成段落(对应 HTML 的 <p> 标签)。

  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 或 四个空格 缩进表示 <pre> 预格式化;

  • 引用、列表的 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),它们拥有不同的宽度,非断行空格(&nbsp;)是常规空格的宽度,可运行于所有主流浏览器。其他几种空格( &ensp;&emsp;&thinsp;&zwnj;&zwj;)在不同浏览器中宽度各异。

entitycodefull-namewidth
&nbsp;&#160;no-break space键盘空格(space bar)
&ensp;&#8194;en space半角空格(half-width)
&emsp;&#8195;em space全角空格(full-width)

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


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

分隔线(Horizontal Rules)

你可以在一行中用三个以上的星号(asterisks:*)或减号(hyphens:-)或底线(underscores:_)来建立一个水平分隔线,对应 HTML 中的 <hr> 标签,用于Sentence/Section/Page Break。 
行内不能有其他东西,但你可以在星号或是减号中间插入空格。 
下面每种写法都可以建立起分隔线:

---- - ------1234

注意:

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

文本格式(Text Styling)

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

强调(Italic/Emphasize)

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

语法:

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

示例: 
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 中的 <b> / <strong> 标签。

语法:

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

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

突出(Mark/Highlight)

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

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

示例: 
Macdown 和 Haroopad:==Highlight==

下划线(Underline)

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

语法: 
Macdown:_underline_ 
Haroopad:++underline++

示例: 
Macdown:underline 
Haroopad:++underline++

删除线(Strikethrough)

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

语法:

~~Strikethrough~~12

示例: 
Strikethrough

脚标(Script)

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

上脚标:

Haroopad 语法(Caret):^Superscript^ 
HTML 语法:<sup>superscript</sup>

示例: 
2^10^ = 210 = 1024;

下脚标:

Haroopad 语法:~Subscript~ 
HTML 语法:<sub>subscript</sub>

示例: 
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 等效源码为 <a href="url">text</a>。 
如果是要链接到本机资源,可以使用相对路径(./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 等效源码为 <img class="lazy" data-src="url" alt="text" />,其中alt_text可以置空。


daringfirefall logo: 
![daringfirefall](http://daringfireball.net/graphics/logos/) 
Markdown怎么使用

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

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

<div style="text-align:center"><img class="lazy" data-src="http://avatar.csdn.net/9/D/B/1_phunxm.jpg" align="middle"  alt="程序猿-弦苦" /></div>1

Markdown怎么使用

图片链接

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


定义 haroopad logo 指向首页: 
[![](http://pad.haroopress.com/assets/images/logo-small.png "haroopad")](http://pad.haroopress.com/)

Markdown怎么使用

锚点(inner link)

书签(Bookmark)

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


  1. 先定义锚点id:<a href="#auchor_id">bookmark_text</a>

  2. 再定义一个id为auchor_id的对象(这里以<p>为例):<p id="auchor_id">auchor_text</p>


例如,我们在文末定义了id为end的 EOF(End Of File):<p id="end">The end!</p>,然后通过<a href="#end">Goto the End!</a>指定书签“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)”的着色添加的脚注:

## <font color='red'>标题(Header)</font>[^Header][^Header]:这里的源码为`<font color='red'>标题(Header)</font>`,尝试使用 font.color 着色。123

说明:

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

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

引用(Blockquote)

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

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 中的 <code> 标签(把文本变成等宽字体,暗示是源程序代码)。 
如果要在代码区段内插入反引号,可以用多个反引号来开启和结束代码区段。

语法:

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

示例:

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

代码块(Code Blocks)

说明:

  • Preformatted Code Block 
    如果要插入跨行片段或块,且要保持排版样式(包括空格、换行符和缩进),可使用预格式化引用语法格式。对应 HTML 中的 <pre> 标签。

  • Fenced Code Block 
    如果要支持编程语言语法高亮,则可以使用 GFM 扩展的基于 YAML2 标记语言的 Fenced Code Block 引用语法格式。

语法:

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

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

languagealiases
Markdown无别名,注意区分大小写
HTMLxhtml
JavaScriptjsnode
C无别名,注意区分大小写
C++cpp
Objective-Cobj-cobjcobjectivec
VimLvimnvim

示例:


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,而割断代码块成片段!


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 <UIKit/UIKit.h>#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) <!--行首缩进1个tab-->    - 文字(text href)        - 行内式(Inline) <!--行首缩进2个tab-->        - 参考式(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 HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

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

First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

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

NameDescription
HelpDisplay the help window.
CloseCloses a window

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

NameDescription
HelpDisplay the help window.
CloseCloses a window

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

Left-AlignedCenter AlignedRight Aligned
col 3 issome wordy text$1600
col 2 iscentered$12
zebra stripesare 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. 这里的源码为<font color='red'>标题(Header)</font>,尝试使用 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怎么使用”这篇文章的内容,相信大家都有了一定的了解,希望小编分享的内容对大家有帮助,若想了解更多相关的知识内容,请关注编程网行业资讯频道。

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

Markdown怎么使用

下载Word文档到电脑,方便收藏和打印~

下载Word文档

猜你喜欢

Markdown怎么使用

这篇“Markdown怎么使用”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“Markdown怎么使用”文章吧。HTML 以
2023-06-02

Vue怎么使用Markdown文档

这篇文章主要讲解了“Vue怎么使用Markdown文档”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“Vue怎么使用Markdown文档”吧!1、首先下载mavon-editornpm ins
2023-07-05

markdown绘图插件mermaid怎么使用

使用Markdown绘图插件Mermaid,可以通过以下步骤进行使用:安装Mermaid插件:在Markdown编辑器中搜索Mermaid插件,并安装到浏览器或编辑器中。常见的编辑器如Typora、VS Code等都支持Mermaid插件。
2023-10-26

怎么使用基于Ace的Markdown编辑器

本篇内容介绍了“怎么使用基于Ace的Markdown编辑器”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!我认为的编辑器分成两类,一种是分为左
2023-06-25

Markdown使用方法有哪些

本文小编为大家详细介绍“Markdown使用方法有哪些”,内容详细,步骤清晰,细节处理妥当,希望这篇“Markdown使用方法有哪些”文章能帮助大家解决疑惑,下面跟着小编的思路慢慢深入,一起来学习新知识吧。Markdown 是一种轻量级的标
2023-07-05

怎么使用pandoc将Markdown转换为格式化文档

小编给大家分享一下怎么使用pandoc将Markdown转换为格式化文档,相信大部分人都还不怎么了解,因此分享这篇文章给大家参考一下,希望大家阅读完这篇文章后大有收获,下面让我们一起去了解一下吧!基本转换首先,在你的计算机上安装 pando
2023-06-16

Vue使用Markdown文档的示例

本文主要介绍了Vue使用Markdown文档的示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2023-05-13

markdown编辑器tui.editor如何使用

这篇文章主要介绍“markdown编辑器tui.editor如何使用”的相关知识,小编通过实际案例向大家展示操作过程,操作方法简单快捷,实用性强,希望这篇“markdown编辑器tui.editor如何使用”文章能帮助大家解决问题。安装使用
2023-07-05

如何使用Vite2+Vue3渲染Markdown文档

本篇内容主要讲解“如何使用Vite2+Vue3渲染Markdown文档”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“如何使用Vite2+Vue3渲染Markdown文档”吧!目录自定义 Vite
2023-06-20

怎么在Github Markdown中打空格

本篇内容介绍了“怎么在Github Markdown中打空格”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!在Github Markdown中
2023-07-06

Easy Markdown for Mac工具有什么用

小编给大家分享一下Easy Markdown for Mac工具有什么用,希望大家阅读完这篇文章之后都有所收获,下面让我们一起去探讨吧!Easy Markdown for Mac破解版是一款专业的纯文本编辑软件,采用Markdown语法编写
2023-06-02

如何使用JavaScript+Node.js写一款markdown解析器

这篇文章主要介绍了如何使用JavaScript+Node.js写一款markdown解析器,具有一定借鉴价值,感兴趣的朋友可以参考下,希望大家阅读完这篇文章之后大有收获,下面让小编带着大家一起了解一下。1. 准备工作首先编写getHtml函
2023-06-29

纯CSS怎么实现markdown自动编号

本文将为大家详细介绍“纯CSS怎么实现markdown自动编号”,内容步骤清晰详细,细节处理妥当,而小编每天都会更新不同的知识点,希望这篇“纯CSS怎么实现markdown自动编号”能够给你意想不到的收获,请大家跟着小编的思路慢慢深入,具体
2023-06-08

编程热搜

  • Python 学习之路 - Python
    一、安装Python34Windows在Python官网(https://www.python.org/downloads/)下载安装包并安装。Python的默认安装路径是:C:\Python34配置环境变量:【右键计算机】--》【属性】-
    Python 学习之路 - Python
  • chatgpt的中文全称是什么
    chatgpt的中文全称是生成型预训练变换模型。ChatGPT是什么ChatGPT是美国人工智能研究实验室OpenAI开发的一种全新聊天机器人模型,它能够通过学习和理解人类的语言来进行对话,还能根据聊天的上下文进行互动,并协助人类完成一系列
    chatgpt的中文全称是什么
  • C/C++中extern函数使用详解
  • C/C++可变参数的使用
    可变参数的使用方法远远不止以下几种,不过在C,C++中使用可变参数时要小心,在使用printf()等函数时传入的参数个数一定不能比前面的格式化字符串中的’%’符号个数少,否则会产生访问越界,运气不好的话还会导致程序崩溃
    C/C++可变参数的使用
  • css样式文件该放在哪里
  • php中数组下标必须是连续的吗
  • Python 3 教程
    Python 3 教程 Python 的 3.0 版本,常被称为 Python 3000,或简称 Py3k。相对于 Python 的早期版本,这是一个较大的升级。为了不带入过多的累赘,Python 3.0 在设计的时候没有考虑向下兼容。 Python
    Python 3 教程
  • Python pip包管理
    一、前言    在Python中, 安装第三方模块是通过 setuptools 这个工具完成的。 Python有两个封装了 setuptools的包管理工具: easy_install  和  pip , 目前官方推荐使用 pip。    
    Python pip包管理
  • ubuntu如何重新编译内核
  • 改善Java代码之慎用java动态编译

目录