欢迎使用优快云-markdown -->这是文章题目

最新推荐文章于 2025-06-26 15:29:14 发布

hjjdebug

最新推荐文章于 2025-06-26 15:29:14 发布

阅读量1.6k

点赞数

CC 4.0 BY-SA版权

分类专栏：杂项

本文链接：https://blog.youkuaiyun.com/hejinjing_tom_com/article/details/71374193

杂项专栏收录该内容

20 篇文章

订阅专栏

本文介绍了如何使用Markdown编辑器编写格式丰富且易于阅读的文章。涵盖了基本语法如标题、列表、引用，以及高级特性如表格、代码块和数学公式的使用方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

欢迎使用Markdown编辑器写博客

hjjnote: 上面是一号标题

hjjnote:这是我学习markdown 的地方,过几天就删除该文档

hjjnote:

关于markdown 文本编辑格式,

markdown 是把无格式文本加上了若干标示的文本.

markdown 的显示格式由渲染环境根据它的CSS环境来渲染,例如多个空格为一个空格,首行无空格,多个tab为一个tab, 多个回车为一个回车.

这样的渲染格式也常常让初学者感到迷惑, 我文本书写中是有对齐格式的,但渲染环境没有表现出来.这个我们慢慢来解决.因为它认为,文本排版不需要我们书写者操心! 我们姑且认为它的提法是对的.

现在我们来看看它的一些语法特性:

它认为: 段落是由一个单独的回车来分割的,这个我们容易接受.

它认为: 段落并不需要首行缩进2个字符,这个与我们传统的中文写作方式不同.因为打空格或者tab都不能使首行缩进,一定要缩进就要用点小手段,如下:

这是首行不缩进的例子
这是首行输入4个&nbsp加上;的情况,这个&nbsp是不断行空格.
这是首行2个&ensp加上分号的显示情况,这个&ensp加分号是英文空格
这是首行1个&emsp加上分号的显示情况.这个&emsp分号是中文空格

这样虽在渲染中看得不错了,但在书写环境下看着却不舒服.所以最好还是不要这种排版, 而要尽量符合它的排版习惯.

在html中,段落并不靠首行两字符缩进来指示,而是靠增加一个空行来指示. 所以显示还是很清晰的, 当一定要符合中文出版习惯时,可以采用上述变通办法.

它认为: 首行对齐的行构成一个段落. 但段内的回车并不能在渲染环境中表现出来.
在一段文本中,你不需要输入回车, 由渲染环境根据宽度需要自动加入回车来显示,这加入的换行就是自动换行.

所以,当你需要加入回车时,多半是需要加入两个回车,以便构成段落分割.

如果我一定要在段内加入一个回车怎么办? 一般的,它是不建议你插入这种硬回车,如果一定要这么做,用2个空格+回车.

它认为: 首行由超过4个空格构成就构成了段落引用.

而缩进呢,相同的缩进构成同一个段落.而查过4个格的缩进就是代码块引用了
就像这里所示,是原样照印,回车表现为回车,空格表现为空格.

它的这种渲染环境,一定程度上破坏了我们所见即所得的直观感受,是不是一种倒退呢? 尤其是对于我们这类写代码的程序员!

原来markdown不是主要用来写代码的,而是主要用来写文章的.

它有大标题,二标题,三标题一直到六标题.标题表示了章,节,小节,小小节…,
节下面有列表, 1. 2. 3. 或a. b. c. 有序列表或无序列表或者说明性列表:

兼顾到程序员的需要,当需要保留排版格式时,可以用引用或者代码引用把它包围起来.

下面是一个无格式列表

Markdown和扩展Markdown简洁的语法
代码块高亮
图片链接和图片上传
LaTex数学公式
UML序列图和流程图
离线写博客
导入导出Markdown文件
丰富的快捷键

hjjnote:可见csdn 支持markdown 和 markdown 扩展语法
至于图片,链接,数学公式,流程图我还不会写, 要慢慢学

hjjnote:分割线,我明白

快捷键

hjjnote:二号标题我也明白

加粗 Ctrl + B
斜体 Ctrl + I
引用 Ctrl + Q
插入链接 Ctrl + L
插入代码 Ctrl + K
插入图片 Ctrl + G
提升标题 Ctrl + H
有序列表 Ctrl + O
无序列表 Ctrl + U
横线 Ctrl + R
撤销 Ctrl + Z
重做 Ctrl + Y

hjjnote: 上面是在一行内就能写下的无序列表.

这些快捷键菜单栏有按钮,用多了就记住了,例如斜体用Ctrl-I ,表示斜体, 我就是这样加入标注

Markdown及扩展

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]

使用简单的符号标识不同的标题，将某些文字标记为粗体或者斜体，创建一个链接等，详细语法参考帮助？。

hjjnote:粗体,斜体我知道了, 6级标题也知道, 引用用> it’s easy,

本编辑器支持 Markdown Extra , 　扩展了很多好用的功能。具体请参考Github.

表格

Markdown　Extra　表格语法：

项目	价格
Computer	$1600
Phone	$12
Pipe	$1

hjjnote:表格已经掌握, 要想快速编辑,还是用vim 书写比较快

可以使用冒号来定义对齐方式：

项目	价格	数量
Computer	1600 元	5
Phone	12 元	12
Pipe	1 元	234

hjjnote:表格内容对齐也很简单

定义列表

Markdown　Extra　定义列表语法：项目１项目２

定义 A

定义 B

项目３

定义 C

定义 D hjjnote:定义部分前面是有个冒号的:

定义D内容
hjjnote: 引用内回车即为硬回车.而且左端自动对齐.
说明式列表,内容前面加个> 表示是引用.

代码块

代码块语法遵循标准markdown代码，例如：

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''