Markdown基本用法

最新推荐文章于 2024-06-21 16:38:47 发布
最新推荐文章于 2024-06-21 16:38:47 发布
阅读量609 收藏 4
点赞数 1
分类专栏： It技巧 IT知识 Android 自定义view、动画 文章标签： markdown
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u014720022/article/details/93312191
版权

Markdown基本用法

背景

刚开始接触Markdown是由于经常逛Github的原因，Github的开源项目中一般都会有README.md这个文件，该文件就是用Markdown语法写的，很明显可以看出用了该语法后，文档看起来会给人特别的简洁、舒服的感觉，所以至那后我便开始喜欢上了用Markdown写文档、博客之类的了。

简介

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

Markdown 语法在 2004 年正式问世，是一种常用的计算机语法，目的在于帮助与文字、代码相关的工作者在不需要进行复杂排版的条件下直接使用标记语言来完成 HTML 排版。Markdown 得到了包括 GitHub、Reddit 等在内的主流互联网技术和内容平台的支持。
但由于 Markdown 语言自从创立以来就没有进行过大的版本更新，而各大主要的使用者都对其语法的部分细节进行过小的修改，导致第三方版本千变万化，语法存在一定程度碎片化的情况。

  • 优点
    • 纯文本，兼容性强，支持各类文本编辑器。
    • 格式转换方便，Markdown的文本可以轻松转换为HTML、PDF格式等。
    • 结构清晰，排版美观，易读性强。
    • 支持Markdown语法的编辑器有很多，部分网站也支持，如：简书、CSDN等
  • 缺点
    • 无法进行复杂的排版，这一点不如Word文档

语法

1.目录/锚点

语法：

- [标题名称](#锚点标题名称)

锚点标题名称需注意：

  • #后不能加空格
  • 英文全部必须小写
  • 空格替换成-
  • .直接去掉

推荐使用相对路径，不会因为项目搬迁而失效。

2.标题

标题目前最大支持6个级别，大于6个’#‘则无效，多个’#‘分别对应多少个级别。其中’#’ 和标题必须要用空格分开，不能连接在一起。

# 一级标题  <!-- omit in toc -->
## 二级标题  <!-- omit in toc -->
### 三级标题  <!-- omit in toc -->
#### 四级标题  <!-- omit in toc -->
##### 五级标题  <!-- omit in toc -->
###### 六级标题  <!-- omit in toc -->

3.文本

3.1 普通文本

大家好我是小白！

3.2 文本块

在文本的开头加上1个Tab或者4个空格即可
离思五首·其四

【作者】元稹 【朝代】唐 

曾经沧海难为水，

除却巫山不是云。

取次花丛懒回顾，

半缘修道半缘君。
3.3 换行

一行结束时输入两个空格

4.字体

4.1 斜体

斜体1
斜体2

4.2 粗体

粗体1
粗体2

4.3 粗斜体

粗斜体1
粗斜体2

4.4 删除线

删除线

####  下划线（有道支持）

++ 下划线 ++  

####  标记（有道支持）

== 地方 ==

5.分割线

三个及以上的’-’,’*’,’_'都可以生成分割线。

6.列表

6.1 无序列表

无序列表可以使用+、-、*作为开头标记：

  • 特点
  • 功能
  • 资料
  • 特点
  • 功能
  • 资料
  • 特点
  • 功能
  • 资料
6.2 多级无序列表
  • 特点
    • 功能
      • 资料
6.3 有序列表

有序列表则使用数字接着一个英文句点：

  1. 步骤一
  2. 步骤二
  3. 步骤三
6.4 多级有序列表
  1. 步骤一
    1. 步骤二
      1. 步骤二
6.5 待办事项
  • 待办事项1
  • 待办事项2
6.6 多级待办事项
  • 待办事项1
    • 待办事项2
      • 待办事项2

7.代码块

https://help.github.com/en/articles/creating-and-highlighting-code-blocks

alert('Hello World');

public static void main(String[]args){} //Java

int main(int argc, char *argv[]) //C

echo "hello GitHub" #Bash

document.getElementById("myH1").innerHTML="Welcome to my Homepage"; //Javascript

string &operator+(const string& A,const string& B) //cpp

8.表格

  • 写法1，开头结尾添加’|’：
表头表头表头
单元单元单元
  • 写法2，开头结尾都不添加’|’：
表头表头表头
单元单元单元
  • 写法3，可多添加’-’：
表头表头表头
单元单元单元

其中’-'至少需要一个，为了对齐，可多加了几个。

  • 对齐
默认对齐左对齐居中对齐右对齐
-:-:-:-:

:表示默认左对齐，:-表示左对齐，:-:表示居中对齐，-:表示右对齐，-数目至少需要一个，第二行的对齐方式必须要有，否则不是表格形式。

  • 混合表格
图片斜体粗体粗斜体删除线顶部
单元粗体粗斜体删除线顶部

9.图片

  • 无提示

  • 鼠标悬浮提示

Github仓库里的图片
方式一：https://raw.githubusercontent.com/用户名/仓库名/分支名/文件夹路径/图片
https://raw.githubusercontent.com/Brainbg/CloudPic/master/Markdown/github_icon.png


方式二：https://github.com/用户名/仓库名/raw/分支名/文件夹路径/图片
Github图片原链接：https://github.com/Brainbg/CloudPic/blob/master/Markdown/github_icon.png
把blob改成raw
https://github.com/Brainbg/CloudPic/raw/master/Markdown/github_icon.png
本地图片

10.超链接

百度
百度

11.引用

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码：

return shell_exec("echo $input | $markdown_script");

diff

+ dfd
+ dfd
- dfd
- dfdf
+ dfdf
- dfdf
- dfdf

### 绘图（有道云笔记支持）
#### 流程图
#### 序列图
#### 甘特图
#### 数学公式

常用的Markdown 编辑器

  • OSX
    • VSCode
    • Atom
    • Byword
    • Mou
    • Typora
    • MacDown
    • RStudio
  • Linux
    • VSCode
    • Atom
    • Typora
    • ReText
    • UberWriter
    • RStudio
  • Windows
    • VSCode
    • 有道云笔记
    • Atom
    • CuteMarkEd
    • MarkdownPad2
    • Miu
    • Typora
    • RStudio
  • iOS
    • Byword
  • Android
    • 有道云笔记
    • 印象笔记
  • 浏览器插件
    • MaDo (Chrome)
    • Marxico（Chrome）
  • 高级应用
    • Sublime Text 3 + MarkdownEditing / 教程 [1]

参考

Github中的图片

作者：Brainbg(白雨)
GitHub：https://github.com/Brainbg
博客：https://www.brainbg.com/
简书：https://www.jianshu.com/u/94518ede7100
CSDN：https://blog.csdn.net/u014720022

浮典
关注
  • 1
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
初学者必看Markdown 使用指南
技术专家
07-19 5238
Markdown 文档遵循一种特定的语法，容易阅读和写作。它们是纯文本，所以能够通过电脑上的任何文本编辑器来创建。
Markdown基本使用
weixin_41847052的博客
12-11 278
Markdown 笔记 标题 一级标题：在底部用一行等号或者在左侧用#加空格标记。 二级标题：在底部用一行-或者在左侧用两个#加空格标记。 用不同数量的 # 表示1-6级的标题。 # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 这个文档里的小标题都是三级标题~ 特殊文本 斜体文本和粗体文本以及***粗斜体文...
stackedit.js：将StackEdit添加到任何网站
02-03
Stackedit.js 将StackEdit添加到任何网站 构建设置 # install dependencies npm install # watch and build for dev npm run dev # build for production npm run build 快速开始 将StackEdit绑定到textarea ： // Import the lib. import Stackedit from 'stackedit-js' ; // Get the textarea. const el = document . querySelector ( 'textarea' ) ; // Create the Stackedit object. const stackedit = new Stackedit ( ) ; // Open the iframe stackedit . openFile ( { name : 'Filename' , // with a filename content : { text : el . value
Markdown编辑小技巧——文字篇（一）
真的好想再回到那时，可现在能做的只有补救。————个人博客：https://w7h1te.github.io/
03-12 675
Markdown编辑小技巧——文字篇（一）
【StackEdit Markdown】StackEdit Markdown编辑器本地部署并实现远程访问编辑内容
最新发布
Koma_zhe的学习笔记
06-21 377
【StackEdit Markdown】StackEdit Markdown编辑器本地部署并实现远程访问编辑内容
MarkDown文本编辑：更好的记录方式
Nothing
10-20 205
MarkDown文本编辑：更好的记录方式 Markdown是一种标记语言，支持html, tex latex。 1. MarkDown的标题 标题通过#+空格+文本内容实现，标题最高支持到六级 # 一级标题 ## 二级标题 ### 三级标题 2. MarkDown段落 MarkDown的段落分为有序与无序两种 2.1 有序段落 有序段落通过数字键+.+信息内容实现： 1. 段落1： 2. 段落2： 效果如下 段落1： 段落2： 2.1.1 分级段落 通过Enter+Tab我
Markdown文本的用法
hope_hope1的博客
04-19 273
1、分隔线：三个***号|| — 都是分隔线。1、一级标题：#加空格 文本名称。3、三级标题 ### 个以此类推。: >加说要说的字体是引用标题。: 两边加两个**号是粗体。1、表格：CtrI + t。：两边加三个*号是斜体加粗。2、二级标题：##加空格。：两边加两个~号是删除线。：两边加一个*号是斜体。1、有序列表：1.空格。无序列表：- + 空格。：[标题]加(链接)
MarkDown基本用法.xmind
01-22
MarkDown基本用法.xmind
MarkDown的基本使用.md
07-07
对MarkDown常用的标签进行了介绍
markdown的使用方法和基本语法
08-18
markdown的使用方法和基本语法
typora MarkDown 基本常用使用手册
12-21
typora MarkDown 基本常用使用手册 一.typora 是什么 typora是一款轻便简洁的 MarkDown 编译器，区别于其他编译器的一点是及时渲染。、 二.typora markdown 使用 标题(总共六个级别1-6从大到小) 标题级别 代码 ...
Markdown：Markdown基本语法
02-03
下面将详细介绍Markdown的基本用法。 ### 1. 段落与换行 在Markdown中，一个段落是由一个或多个连续的行组成。如果想在一个段落结束后换行，只需要留一空行即可。连续的两个空行会被解析为一个段落分隔。 ### 2. ...
Markdown用法入门
08-25
Markdown用法详细介绍与整理。里面包含着基本的操作，以及一些本人进行代码实践的细节。
docsify 本地 markdown 美化
07-16
3. **Markdown美化方法**： - 使用Markdown扩展语法：如表格、流程图、LaTeX公式等，增强文档表现力。 - Docsify插件：例如，`docsify-plugin-mathjax`支持数学公式显示，`docsify-search`提供搜索功能。 - CSS...
markdown的使用.pdf
10-09
Markdown是一种轻量级的标记语言，它允许人们...通过掌握这些Markdown基本语法和Typora的快捷键，你将能够高效地编写结构清晰、美观的笔记文档。 Typora的简洁界面和丰富的功能使得Markdown写作变得更为便捷和愉快。
及其详细的Markdown基础-学习笔记（附有使用案例）
qq_57508808的博客
02-13 1115
详细的介绍了如何在Markdown中使用各式各样的代码以生成理想的文档，并且带有示例案例展示具体效果
【Android -- 写作工具】Markdown 代码块
Kevin Learn Android
05-26 3777
关于代码块，Markdown 作者给出的定义如下：Markdown 作为一种排版工具语言，
Markdown语法详细整理
weixin_50874065的博客
11-29 4561
1.标题 几个#就是几级标题，最小是六级标题，标题格式为：#（最多六个）+空格+标题名 四级标题 五级标题 2.文本 1）黑体 文本两边加两个* hello world 2）斜体 文本两边加一个* hello world 3）黑体加斜体 文本两边加三个* hello world 4）注释文本 文本两边加两个~ hello world 3.引用 ​ 英文> +空格+引用内容 即使再小的帆也能远航 4.分割线 分割线用来分割上下内容的，可以是三个-或者是三个* 5.超链接 超链接就.
markdown基本用法
07-25
如果你想了解更多关于Markdown的基本用法，你可以使用搭载Markdown的Typora编辑器和阅读器进行学习。\[2\] #### 引用[.reference_title] - *1* *3* [初学者必看Markdown 使用指南]...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值