Markdown: Basics （快速入门）

最新推荐文章于 2024-07-13 17:11:15 发布
最新推荐文章于 2024-07-13 17:11:15 发布
阅读量68 收藏
点赞数
文章标签： markdown python xhtml
原文链接：https://my.oschina.net/magicly007/blog/210376
版权

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

Markdown现在作为写blog的标记语言越来越流行，github和oschina都支持，于是也学习一下。

#段落、标题、区块代码

一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。

Markdown 支持两种标题的语法，Setext 和 atx 形式。Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。

区块引用则使用 email 形式的 '>' 角括号。

Markdown 语法:

A First Level Header
====================
A Second Level Header
---------------------

Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.

The quick brown fox jumped over the lazy
dog's back.
### Header 3

> This is a blockquote.
> 
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

显示效果为：

A First Level Header

A Second Level Header

Now is the time for all good men to come to the aid of their country. This is just a regular paragraph.

The quick brown fox jumped over the lazy dog's back.

Header 3

This is a blockquote.

This is the second paragraph in the blockquote.

This is an H2 in a blockquote

#修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。

Markdown 语法:

Some of these words *are emphasized*.
Some of these words _are emphasized also_.
Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.

显示效果为：

Some of these words are emphasized. Some of these words are emphasized also. Use two asterisks for strong emphasis. Or, if you prefer, use two underscores instead.

#列表

无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号：

* Candy.
* Gum.
* Booze.

显示效果为：

  • Candy.
  • Gum.
  • Booze.

有序的列表则是使用一般的数字接着一个英文句点作为项目标记：

1. Red
2. Green
3. Blue

显示效果为：

  1. Red
  2. Green
  3. Blue

#链接

Markdown 支援两种形式的链接语法： 行内 和 参考 两种形式，两种都是使用角括号来把文字转成连结。

行内形式是直接在后面用括号直接接上链接：

This is [github](http://github.com/ "github").

显示效果为：

This is github.

参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容：

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"

显示效果为：

I get 10 times more traffic from Google than from Yahoo or MSN.

title 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写：

#图片

图片的语法和链接很像。

行内形式（title 是选择性的）：

![我的头像](http://static.oschina.net/uploads/user/53/106378_50.jpg "Title")

显示效果为：

我的头像

#代码

在一般的段落文字中，你可以使用反引号 ` 来标记代码区段，区段内的 &、< 和 > 都会被自动的转换成 HTML 实体，这项特性让你可以很容易的在代码区段内插入 HTML 码：

I strongly recommend against using any `<blink>` tags.

I wish SmartyPants used named entities like `&mdash;`
instead of decimal-encoded entites like `&#8212;`.

显示效果为：

I strongly recommend against using any <blink> tags.

I wish SmartyPants used named entities like &mdash; instead of decimal-encoded entites like &#8212;.

如果要建立一个已经格式化好的代码区块，只要每行都缩进 4 个空格或是一个 tab 就可以了，而 &、< 和 > 也一样会自动转成 HTML 实体。

Markdown 语法:

If you want your page to validate under XHTML 1.0 Strict,
you've got to put paragraph tags in your blockquotes:

<blockquote>
<p>For example.</p>
</blockquote>

显示效果为：

If you want your page to validate under XHTML 1.0 Strict, you've got to put paragraph tags in your blockquotes:

<blockquote> <p>For example.</p> </blockquote>

Refers:

  1. http://wowubuntu.com/markdown/basic.html
  2. http://jianshu.io/p/q81RER
  3. http://www.ituring.com.cn/article/23
  4. http://www.oschina.net/question/100267_75314

本文的Markdown如下：

Markdown现在作为写blog的标记语言越来越流行，[github][github]和oschina都支持，于是也学习一下。

#段落、标题、区块代码

一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。

Markdown 支持两种标题的语法，[Setext][Setext] 和 [atx][atx] 形式。Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。

区块引用则使用 email 形式的 '>' 角括号。

Markdown 语法:

	A First Level Header
	====================
	A Second Level Header
	---------------------
	
	Now is the time for all good men to come to
	the aid of their country. This is just a
	regular paragraph.
	
	The quick brown fox jumped over the lazy
	dog's back.
	### Header 3
	
	> This is a blockquote.
	> 
	> This is the second paragraph in the blockquote.
	>
	> ## This is an H2 in a blockquote

显示效果为：

A First Level Header
====================
A Second Level Header
---------------------

Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.

The quick brown fox jumped over the lazy
dog's back.
### Header 3

> This is a blockquote.
> 
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

#修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。

Markdown 语法:

	Some of these words *are emphasized*.
	Some of these words _are emphasized also_.
	Use two asterisks for **strong emphasis**.
	Or, if you prefer, __use two underscores instead__.

显示效果为：

Some of these words *are emphasized*.
Some of these words _are emphasized also_.
Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.

#列表

无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号：

	* Candy.
	* Gum.
	* Booze.

显示效果为：

* Candy.
* Gum.
* Booze.

有序的列表则是使用一般的数字接着一个英文句点作为项目标记：

	1. Red
	2. Green
	3. Blue

显示效果为：

1. Red
2. Green
3. Blue

#链接

Markdown 支援两种形式的链接语法： 行内 和 参考 两种形式，两种都是使用角括号来把文字转成连结。

行内形式是直接在后面用括号直接接上链接：

	This is [github](http://github.com/ "github").

显示效果为：

This is [github](http://github.com/ "github").

参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容：

	I get 10 times more traffic from [Google][1] than from
	[Yahoo][2] or [MSN][3].
	
	[1]: http://google.com/ "Google"
	[2]: http://search.yahoo.com/ "Yahoo Search"
	[msn]: http://search.msn.com/ "MSN Search"

显示效果为：

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"

title 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写：

#图片

图片的语法和链接很像。

行内形式（title 是选择性的）：

	![我的头像](http://static.oschina.net/uploads/user/53/106378_50.jpg "Title")

显示效果为：

![我的头像](http://static.oschina.net/uploads/user/53/106378_50.jpg "Title")


#代码

在一般的段落文字中，你可以使用反引号 ` 来标记代码区段，区段内的 &、< 和 > 都会被自动的转换成 HTML 实体，这项特性让你可以很容易的在代码区段内插入 HTML 码：

	I strongly recommend against using any `<blink>` tags.
	
	I wish SmartyPants used named entities like `&mdash;`
	instead of decimal-encoded entites like `&#8212;`.

显示效果为：

I strongly recommend against using any `<blink>` tags.

I wish SmartyPants used named entities like `&mdash;`
instead of decimal-encoded entites like `&#8212;`.

如果要建立一个已经格式化好的代码区块，只要每行都缩进 4 个空格或是一个 tab 就可以了，而 &、< 和 > 也一样会自动转成 HTML 实体。

Markdown 语法:

	If you want your page to validate under XHTML 1.0 Strict,
	you've got to put paragraph tags in your blockquotes:
	
	<blockquote>
	<p>For example.</p>
	</blockquote>

显示效果为：

If you want your page to validate under XHTML 1.0 Strict,
you've got to put paragraph tags in your blockquotes:

<blockquote>
<p>For example.</p>
</blockquote>



Refers:
1. [http://wowubuntu.com/markdown/basic.html](http://wowubuntu.com/markdown/basic.html)
2. [http://jianshu.io/p/q81RER](http://jianshu.io/p/q81RER)
3. [http://www.ituring.com.cn/article/23](http://www.ituring.com.cn/article/23)
4. [http://www.oschina.net/question/100267_75314](http://www.oschina.net/question/100267_75314)


[github]: http://github.com
[Setext]: http://docutils.sourceforge.net/mirror/setext.html
[atx]: http://www.aaronsw.com/2002/atx/

转载于:https://my.oschina.net/magicly007/blog/210376

weixin_34392435
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Markdown 基本语法
weixin_44600183的博客
07-16 423
Markdown 基本语法
markdown:Markdown简易入门教程
04-27
MarkdownMarkdown简易入门教程使用方式：点编辑README.md 文件就可以看到所有markdown格式，照着来用就行了 标题一标题二标题三标题四标题五标题六三空格+换行＝换行 斜体粗体斜体加粗体中划线++下划线++==标记==...
Markdown: Basics （快速入门）[转]
weixin_30853329的博客
06-04 60
Markdown: Basics （快速入门） / (点击查看完整语法说明) Getting the Gist of Markdown's Formatting Syntax 【转自：http://wowubuntu.com/markdown/basic.html】 此页提供了 Markdown 的简单概念，语法说明页提供了完整详细的文档，说明了每项功能。但是 Markdown 其实很简...
Markdown: Basics （Markdown快速入门）
Zerstorung durch Fortschritte der Technologie
06-09 1115
Getting the Gist of Markdown's Formatting Syntax 此页提供了 Markdown 的简单概念， 语法说明 页提供了完整详细的文档，说明了每项功能。但是 Markdown 其实很简单就可以上手，此页文档提供了一些范例，并且每个范例都会提供输出的 HTML 结果。 其实直接试试看也是一个很不错的方法， Dingus 是一个网页应用程序，你可
一文掌握Markdown：入门到精通全攻略
code_magic的博客
03-17 908
欢迎进入“一文掌握Markdown：入门到精通全攻略”，一篇专为希望高效利用Markdown的读者设计的博客。我们的旅程将从Markdown的基础开始，逐步过渡到更为复杂的内容和技巧。无论您是Markdown的新手，还是希望提升已有技能的用户，都能在这篇文章中找到有价值的信息
轻松掌握Markdown：从入门到精通的全面指导.txt
01-22
markdown
markdown::chequered_flag: :chequered_flag: :chequered_flag: markdown入门教程
04-27
如图解释:down_arrow:[google](#text2)可以看到我们使用的是小写，如果我们首字母使用大写[google](# Text2)即便是id地址的确是这么写的也是无法成功运行[markdown](#markdown)图片引用使用 ! [] ( )表格使用| file ...
markdown-tip：markdown提示组件
02-13
link rel =" stylesheet " href =" ./node_modules/markdown-tip/dist/markdown-tip.css " />vuejs组件 npm i markdown-tip-vue import { MarkdownTip } from "markdown-tip-vue"app . component ( 'markdown-...
markdown:markdown.css
03-22
样式基于markdown-nice的主题修改，作者为 ； 代码框样式基于typora的主题修改，作者为 。 这份样式样式使用处理Markdown Typora时，想在Typora上使用的想法。目前大体样式已相同，可正常使用。 2安装 Typora软件：...
1.introduce
qq_38641599的博客
07-10 399
MkDocs 是一个简单且快速的静态网站生成器，专门用于项目文档。它使用Markdown文件作为内容源，基于Python构建，易于配置和使用。
Markdown-it 如何解析超链接的格式，新页签打开
魏晋-
07-11 211
Markdown-it 是一个用于解析 Markdown 文本为 HTML 的库。要使用 Markdown-it 解析超链接并确保它们在新页签中打开，你需要使用 Markdown-it 的插件系统或者自定义规则。规则，在每个链接打开时添加了。属性，以确保新页签的安全性。
【经验总结】将markdown文档转换为word（swagger导出word）
Xcong_Zhu的博客
07-12 413
进阶：自定义样式文件可以参考官方指南：https://pandoc.org/MANUAL.html#option–reference-doc。进入任意swagger-ui页面中，找到离线文档，并拷贝。（也有swagger-ui搭配直接支持下载word文档，直接下载即可）打开md文档，选择导出，选择word，即可获得word文档。（markdown编辑器安装略）
html转markdown nodejs实现
学习使我快乐_玉祥
07-09 256
用到了jsdom库，直接现成处理html标签结构，只需要关心format格式化样式即可。比较简易，待后续优化，目前只是短时间批量转换html文件。
防火、防盗、防windows defender
sjg20010414的专栏
07-11 256
今天我的markdown文件都能给你扫描一遍，明天谁能保证它会扫描什么——虽然WPS那样的软件为了合规也“扫描”用户云端文件，不过，只允许国产流氓，不允许外国强盗，是极端情况下的必然选择。其实也没干啥事，就是备备课，整理一下和 CTF 有关的PHP语言的特性，这个文档用 VSCode 写的，格式是 Markdown （其实也是乱写的，没怎么整理），也就按人家的帖子中的题目，去看看正好用到哪些语言特性。上一个我吃过的跟杀毒软件有关的苦头是360把我的在windows server 2003上的服务给杀了。
markdown语法
qq_33650655的博客
07-11 657
你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：撤销：Ctrl/Command + Z 重做：Ctrl/Command + Y 加粗：Ctrl/Command + B 斜体：Ctrl/Command + I 标题：Ctrl/Command + S
有道云笔记 markdown 生成目录
东皇太一在此的博客
07-12 69
记录了有道云笔记生成目录以及字体增大的语法；
远程帮客户解决“应用程序无法正常启动0xc000007b，请单击确定关闭应用程序”的问题
Hudeyu777的博客
07-13 372
今天收到反馈，SmartPipe软件，在客户机器上报错，无法正常运行，采用远程控制软件进入客户电脑，发现电脑报错如下： 因为客户的电脑是win7，而之前发生过win7电脑上无法运行OCC编写的软件的情况： https://blog.csdn.net/Hudeyu777/article/details/136291559 我就想首先检测一下是不是OCC的库的问题，在本机电脑上找了一个最简单的OCC 7.8.0写的软件，部署了一下，报同样的错误： 结合客户的反馈，当前是win7 专业版系统，之前使用的旗舰版
Jupyter Notebook 使用教程
最新发布
power_9的博客
07-13 447
Jupyter Notebook是一个开源的Web应用程序，允许您创建和共享包含代码、方程、可视化和叙述文本的文档。它在数据清理和转换、数值模拟、统计建模、数据可视化和机器学习等领域得到了广泛应用。文件导航栏：显示您当前目录下的所有文件和文件夹。菜单栏：包含文件操作、编辑、视图等选项。工具栏：包含常用操作按钮，如保存、添加单元格、运行单元格等。单元格区域：用于输入和运行代码或文本。
我的Markdown教程1
08-04
使用Markdown，用户可以快速创建多级标题、列表（无序列表使用*，有序列表使用1.）以及引用等，无需离开键盘。此外，Markdown还支持插入图片（![alt text](url)）和代码块（使用三个反引号```)，甚至可以包含数学...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值