opencv 安装问题

@
返回主页 一块灰色的石头
博客园首页新随笔联系订阅管理
随笔 - 28 文章 - 0 评论 - 6
ubuontu16.04安装Opencv库引发的find_package()错误信息处理及其简单使用
　　在安装完Opencv库之后，打算测试一下Opencv库是否成功安装。下面是用的例子对应的.cpp代码以及对应的CMakeLists.txt代码:

.cpp文件：

复制代码
1 #include <stdio.h>
2 #include <opencv2/opencv.hpp>
3 using namespace cv;
4 int main(int argc, char** argv )
5 {
6 if ( argc != 2 )
7 {
8 printf(“usage: DisplayImage.out <Image_Path>\n”);
9 return -1;
10 }
11 Mat image;
12 image = imread( argv1, 1 );
13 if ( !image.data )
14 {
15 printf(“No image data \n”);
16 return -1;
17 }
18 namedWindow(“Display Image”, WINDOW_AUTOSIZE );
19 imshow(“Display Image”, image);
20 waitKey(0);
21 return 0;
22 }
复制代码
CMakeLists.txt文件：

复制代码
1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 find_package( Opencv REQUIRED)
4 if(Opencv_FOUND)
5 message(STATUS “The Opecv lib is found!”)
6 endif()
7 add_executable( Display test.cpp)
8 arget_link_libraries( Display ${OpenCV_LIBS} )
复制代码
在工程目录下新建并进入build目录，然后输入命令:cmake …
之后出现如下错误信息:

复制代码
CMake Error at CMakeLists.txt:5 (find_package):
By not providing “FindOpencv.cmake” in CMAKE_MODULE_PATH this project has
asked CMake to find a package configuration file provided by “Opencv”, but
CMake did not find one.

Could not find a package configuration file provided by “Opencv” with any
of the following names:

OpencvConfig.cmake
opencv-config.cmake

Add the installation prefix of “Opencv” to CMAKE_PREFIX_PATH or set
“Opencv_DIR” to a directory containing one of the above files. If “Opencv”
provides a separate development package or SDK, be sure it has been
installed.
复制代码
　　根据它的提示，发现cmake 没有找到FindOpencv.cmake文件，之后尝试去找OpencvConfig.cmake。 结果也没有找到。这个就是我们解决问题的突破口。首先我在系统根目录下尝试搜索FindOpencv.cmake，也尝试寻找OpencvCongfig.cmake 结果都没有找到。实际上库的作者都会提供这两个文件，但是我按照Opencv官网上的安装说明编译安装的Opencv库。仍然没有找到。具体原因还不太清楚。于是我在编译好的Opecnv文件的build的目录里面找到了OpenCVConfig.cmake 在/usr/local/share/OpenCV这个目录下同样找到了OpenCVConfig.cmake文件。虽然找到了类似的文件，仍然没有实质性的解决问题。于是我在网上搜索了关于find_package（）命令的有关使用。下面简单介绍Cmake 如何使用find_package命令对外部库进行查找。最后提出解决上面cmake …出现问题的解决方案。
find_package使用简介:
　　首先明确一点，cmake本身不提供任何关于搜索库的便捷方法，也不会对库本身的环境变量进行设置。它仅仅是按照优先级顺序在指定的搜索路径进行查找Findxxx.cmake文件和xxxConfig.cmake文件(其中xxx代表库的名字，特别注意的是有大小写之分)，这两个文件大体上是没有区别的，cmake能够找到这两个文件中的任何一个，我们都能成功使用该库，也就是我们可以用库的内置好了Cmake变量。包含了库的头文件和库文件的路径信息，虽然库的作者一般会提供这两个文件，但是也会遇到安装完毕后找不到的情况。当我们在cmake…命令之后，Cmake 会读取执行CMakeLists.txt中的代码，当执行find_package()这条命令后,Cmake 就会从某些路径中找这Findxxx.cmake文件或者xxxConfig.cmake文件，Cmake找到任意一个之后就会执行这个文件，然后这个文件执行后就会设置好一些Cmake变量。比如下面的变量（NAME表示库的名字 比如可以用Opencv 代表Opencv库）:

_FOUND
_INCLUDE_DIRS or _INCLUDES
_LIBRARIES or _LIBRARIES or _LIBS
_DEFINITIONS
一般常用的就是xxx_FOUND 、xxx_INCLUDE_DIRS、xxx_LIBS，分别代表是否找到库的标志、库的头文件路径、库文件路径。find_package()有两种模式:Module模式和Config模式，分别对应上面的Findxxx.cmake 和xxxConfig.cmake两个文件。cmake默认优先Module模式，而Config模式是备选项。

Module模式(仅仅查找Findxxx.cmake文件):
Cmake会优先搜索CMAKE_MODULE_PATH指定的路径,如果在CMakeLists.txt中没有设置CMAKE_MODULE_PATH为存储Findxxx.cmake的路径，也就是说没有下面的指令：
set(CMAKE_MODULE_PATH “Findxxx.cmake文件所在的路径”)
那么Cmake不会搜索CMAKE_MODULE_PATH指定的路径，此时Cmake会搜索第二优先级的路径，也就是<CMAKE_ROOT>/share/cmake-x.y/Mdodules （注意:x.y表示版本号。我的是3.10）。其中CMAKE_ROOT是你在安装Cmake的时候的系统路径，因为我并没有指定安装路径，所以是系统默认的路径，在我的系统中(ubuntu16.04)系统的默认路径是/usr/loacl，如果你在安装的过程中使用了
cmake -DCMAKE_INSTALL_PREFIX=自己dir路径 ，那么此时CMAKE_ROOT就代表那个你写入的路径 。刚刚说道第一优先级的路径搜索没有找到Findxxx.cmake文件，就会到第二优先级的路径下搜索。如果Cmake在两个路径下都没有找到Findxxx.cmake文件。那么Cmake就会进入Config模式。

Config模式（仅仅查找xxxConfig.cmake文件）：
Cmake会优先搜索xxx_DIR 指定的路径。如果在CMakeLists.txt中没有设置这个cmake变量。也就是说没有下面的指令:
set(xxx_DIR “xxxConfig.cmkae文件所在的路径”)
那么Cmake就不会搜索xxx_DIR指定的路径，此时Cmake 就会自动到第二优先级的路径下搜索，也就是/usr/local/lib/cmake/xxx/中的xxxConfig.cmake文件。
上面主要讲了Cmake的搜索模式。如果Cmake在两种模式提供的路径中没有找到对应的Findxxx.cmake和xxxConfig.cmake文件，此时系统就会提示最上面的那些错误信息。

问题分析：
回顾一下上面的错误信息。根据提示以及上面的两种模式的说明，可以发现我的CMakeLists.txt文件中没有加入设置CMKAE_MODULE_PATH以及Opencv_DIR的命令，那么也就是说Cmake执行find_package后，会自动到两种默认的第二优先级的搜索路径下搜索Findxxx.cmake 和xxxConfig.cmake文件。虽然我在安装Opencv的时候，是默认安装系统目录的，但是我在Moudule模式中的第二优先级搜索路径<CMAKE_ROOT>/share/cmake-x.y/Mdodules里面没有发现FindOpencv.cmake文件。然后我在Config模式中的第二优先级搜索路径/usr/loacl/lib/cmake/中也没有发现Opencv文件夹，更没有找到OpencvConfig.cmake文件了。而是仅仅看到了我之前在系统上安装的Pangolin文件夹，里面确实有对应的PangolinConfig.cmake文件。但是我在/usr/local/share/OpenCV/文件夹中找到了OpenCV.cmake文件。但不是最上面错误信息中提到的OpencvConfig.cmake文件。仅仅是大小写不同。

解决方案:
(1)、我们可以忽略上面的错误信息，因为我们用find_package()查找库的目的是，就是为了用include_directories()包含头文件。用link_directories()包含库文件。最后用target_link_libraries(可执行文件 库)链接动态或者动态的库,所以最简单的方法就是自己在Opencv包的目录下找到头文件路径和库文件路径。可以在CMakeLists.txt中设置如下指令:

复制代码
1 set(Opencv_INCLUDE_DIRS “Opencv库的头文件目录”)
2 set(Opencv_LIBRARIES_DIRS “Opencv库的库文件目录”)
3 set(Opencv_LIBs “具体的链接库文件.a .so”)
4 include_directories($Openc{v}_{I}NCLUD{E}_{D}IRS)5lin{k}_{d}irectories(${Opencv_LIBRARIES_DIRS})
6 target_link_libraries( <执行文件名字> "${Opencv_LIBs} )
复制代码
这里有一点不好的地方就是指令的 “” 部分。前两条指令还可以，我们只要写下具体的文件路径就行了。对于第三条指令。具体链接库的文件 这个就很多了，而且很有可能我们写入的不全，好的情况是我们没有用那么多的库，所以简单的程序可能正常编译运行，但是当程序复杂的时候，所需要的库就不是我们能够考虑到的，我们就必须要把所有可能的库都加入到这里来，只要漏掉了工程需要的库文件或者头文件，都会导致程序编译失败。这是一个致命的缺点。当然对于我自己的情况，我的安装包默认安装到了系统目录，也就是说我可以不添加头文件和库文件路径，仅仅设置下一具体的链接库文件 即以.so .a结尾的文件集。如果你安装到了其他的地方，那么就需要设置包含库文件和头文件的路径。
“Opencv库的头文件目录” 这个路径的选择有两个。一个是安装包的下的include目录，一个是/usr/local/include
“Opencv库的库文件目录” 这个路径的选择有两个。一个是安装包的build/bin，一个是/usr/local/lib
“具体的链接库文件” 这个路径的选择有两个。一个是安装包的build/bin/所有库文件名字，一个是/usr/local/lib下的所有库文件名字 （注意:这个"具体的链接库文件"怎么能够简单的写出来我还不太清楚，仅仅知道把所有文件写出来，如果有人知道简化写，可以给我留言）

(2)、第一种方法虽然回避了上面错误信息的发生，但是在后面也需要做很多的工作。每一步的工作不到位，都可能会导致编译失败。接下来的方法就是按照上面提示的信息寻找需要的FindOpencv.cmake和OpencvConfig.cmake文件。在问题分析里面讨论了，在我的cmake默认的搜索路径中没有包含上面的任何一个文件。仅仅在Opencv安装包和/usr/local/share/OpenCV这两个路径下找到了OpenCV.cmake文件。接下来的操作有四种选择（需要注意的是我的Opencv库默认安装到了系统目录，所以在CMakeLists.txt没有加入包含头文件和库文件的两条指令。）:
一、让系统按照Module模式进行查找，也就是想办法弄出一个FindOpencv.cmake文件，之后设置一下CMAKE_MODULE_PATH变量。下面是具体操作:因为我们在所有目录中没有找到FindOpencv.cmake文件。只能找到OpenCVConfig.cmake文件。我们可以将这个文件名字更改为FindOpencv.cmake（更改方法有很多，如果没有权限可以鼠标右键更改，如果有权限那么必须在命令行中sudo 进行更该）。然后在CMakeLists.txt中加入CMAKE_MODULE_PATH的路径信息。因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/下面直接鼠标右键更改。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
最后的CMakeLists.txt中的命令如下:

复制代码
1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv REQUIRED)
5 if(Opencv_FOUND)
6 message(STATUS “The Opecv lib is found!”)
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )
复制代码
二、让系统按照Config模式进行查找，想办法弄出一个OpencvConfig.cmake文件，之后设置一下Opencv_DIR变量（这里一定是Opencv_DIR 不能是OpenCV_DIR）。下面是具体操作:因为我们在所有目录中没有找到OpencvConfig.cmake文件。只能找到OpenCVConfig.cmake文件。我们可以将这个文件名字更改为OpencvConfig.cmake（具体的更改方法参照上面）。然后在CMakeLists.txt中加入Opencv_DIR的路径信息。因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/下面直接鼠标右键更改。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
最后的CMakeLists.txt中的命令如下:

复制代码
1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv REQUIRED)
5 if(Opencv_FOUND)
6 message(STATUS “The Opecv lib is found!”)
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )
复制代码
三、让系统按照Module模式进行查找，将OpenCVConfig.cmake文件更改为FindOpenCV.cmake,之后设置一下CMAKE_MODULE_PATH路径信息，之后在find_package的时候指定一个名字，比如:find_package(Opencv NAMES OpenCV REQUIRED )。此时find_package就会查找FindOpenCV.cmake文件，下面是具体操作:因为我们在所有目录中没有找到FindOpencv.cmake文件。只能找到OpenCVConfig.cmake文件。我们可以将这个文件名字更改为FindOpenCV.cmake,然后在CMakeLists.txt中加入CMAKE_MODULE_PATH的路径信息。因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/下面直接鼠标右键更改。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
并且修改find_package内容，具体命令如下：
find_package( Opencv NAMES OpenCV REQUIRED)
最后的CMakeLists.txt中的命令如下:

复制代码
1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv NAMES OpenCV REQUIRED)#或者用find_package(OpenCV REQUIRED)
5 if(Opencv_FOUND)
6 message(STATUS “The Opecv lib is found!”)
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )
复制代码
四、让系统按照Config模式进行查找，设置一下Opecv_DIR路径，之后在find_package的时候指定一个名字，比如:find_package(Opencv NAMES OpenCV REQUIRED )。或者显示的指出用Config模式即
find_package(Opencv CONFIGS NAMES OpenCV REQUIRED)，因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/路径对Opencv_DIR设置。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
并且修改find_package内容，具体命令如下：
find_package( Opencv NAMES OpenCV REQUIRED)
最后的CMakeLists.txt中的命令如下:

复制代码
1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv NAMES OpenCV REQUIRED)#或者用find_package(OpenCV REQUIRED)
5 if(Opencv_FOUND)
6 message(STATUS “The Opecv lib is found!”)
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )
复制代码
总结:
你可以灵活的选择上面的两种方法中的任何一种，或者是第二中方法中的任何一种方式。任何一种写法。实际上上面的过程中会有很多的细节，可以自己一一尝试，看看输出的内容到底是什么。find_package具体用法可以参考cmake官方手册。下面将上面的四种方式写的CMakeLists.txt，结合在一起进行对比(默认对应上面四种方式相应的更改了OpenCVCongfig.cmake文件）:

复制代码
1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3
4 #设置Module模式路径(想要使用的话前提要求有FindOpencv.cmake或者FindOpenCV.cmake,之后选择对应的find_package模式，例如FindOpencv.cmake 对应find_package(Opencv REQUIRED)，FindOpenCV.cmake对应find_package(Opencv NAMES OpenCV REQUIRED) )
5 #set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
6 #设置Config模式路径(想要使用的话,前提要有OpencvConfig.cmake或者OpenCVConfig.cmake，之后选择对应的find_package模式，对应关系与Moudule模式同理，需要注意的一点是，我们也可直接显示的使用Config模式，即Cmake不会按照Module模式进行查找。需要调用find_package(Opencv CONFIGS NAMES OpenCV REQUIRED)或者find_package(Opencv CONFIGS REQUIRED))
7 set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
8
9 #对应FindOpenCV.cmake和OpenCVConfig.cmake
10 find_package( Opencv NAMES OpenCV REQUIRED)#或者用find_package(OpenCV REQUIRED)
11
12 #对应FindOpencv.camke和OpencvConfig.cmake
13 find_package( Opencv REQUIRED)
14
15 if(Opencv_FOUND)
16 message(STATUS “The Opecv lib is found!”)
17 endif()
18
19 #下面两个包含头文件路径的命令，可以选择性的添加。因为我默认安装到了系统目录中，所以即使不添加下面的命令，系统也能够默认搜索到头文件。如果你安装这个库到了其他地方，那么下面这句话就是必须的。
20 #添加包含头文件的路径
21 #include_directories(KaTeX parse error: Expected 'EOF', got '#' at position 31: …_DIRS}) 22 23 #̲增加可执行文件 24 add_…{OpenCV_LIBS}是在cmake找到对应的xxxConfig.cmake或者Findxxx.cmake后执行.cmake文件后定义的Cmake变量。注意OpenCV是大写的，因为.cmake文件中仅仅定义了大写的OpenCV_LIBS变量。所以在具体的写其他库的时候，要注意是大写还是小写，可以到相应的.cmake文件中查看。
27 target_link_libraries( Display ${OpenCV_LIBS} )
复制代码
上面的理解可能不全面，更进一步的理解可以查阅下面的参考资料，如果您有更好的理解，或者上面讲解过程中有错误，希望您指出，谢谢！

参考资料：
1、http://blog.csdn.net/bytxl/article/details/50637277#t0
2、https://cmake.org/cmake/help/v3.10/command/find_package.html
3、https://stackoverflow.com/questions/8711109/could-not-find-module-findopencv-cmake-error-in-configuration-process

分类: linux
好文要顶 关注我 收藏该文
灰色的石头
关注 - 0
粉丝 - 20
+加关注
2 0
« 上一篇：ubuntu16.04(其他版本也可)批量修改图片名—shell编程
» 下一篇：ubuntu16.04+Opencv3.4.0安装(slam版)
posted @ 2018-01-27 09:57 灰色的石头 阅读(2717) 评论(0) 编辑 收藏
刷新评论刷新页面返回顶部
注册用户登录后才能发表评论，请 登录 或 注册，访问网站首页。
【推荐】超50万VC++源码: 大型组态工控、电力仿真CAD与GIS源码库！
【活动】申请成为华为云云享专家 尊享9大权益
【腾讯云】拼团福利，AMD云服务器8元/月
腾讯云1129
相关博文：
· ubuntu14.04中安装opencv2.4.13
· Mac下OpenCV开发环境配置（Terminal和Xcode）
· Ubantu14.04下编译OpenCV3.0.0以及读取图片例子
· Linux 中使用 OpenCV
· 树莓派学习：源码方式安装opencv

最新新闻：
· 腾讯获联合国数字技术增强残疾人权能奖 QQ搭建无障碍沟通桥梁
· 微信：已第一时间封禁勒索病毒作者账户 用户安全不受威胁
· 视频圈常青树杨伟东倒掉了 媒体：“经济问题”涉案金额可能逾亿
· 微软模仿ChromeOS打造Windows轻量版推网页APP
· 三星展开重组：手机家电员工转岗至AI等新业务
» 更多新闻…
公告
昵称：灰色的石头
园龄：1年6个月
粉丝：20
关注：0
+加关注
< 2018年12月 >
日 一 二 三 四 五 六
25 26 27 28 29 30 1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31 1 2 3 4 5
搜索

找找看

谷歌搜索
常用链接
我的随笔
我的评论
我的参与
最新评论
我的标签
最新随笔

1. 视觉slam十四讲第8章课后习题3+稀疏直接法程序注释
2. 视觉slam十四讲第七章课后习题6
3. 视觉slam十四讲第七章课后习题7
4. 视觉slam十四讲ch5 joinMap.cpp 代码注释（笔记版）
5. 视觉slam十四讲ch6曲线拟合 代码注释（笔记版）
6. Sopus库中FindEigen3.cmake内容详解笔记
7. Sophus库CMakeLists.txt内容详解笔记
8. CMake中的两种变量(Variable types in CMake)
9. ubuntu16.04+Opencv3.4.0安装(slam版)
10. ubuontu16.04安装Opencv库引发的find_package()错误信息处理及其简单使用
    我的标签
    数据结构与算法(3)
    ubuntu(2)
    数据结构(2)
    随笔分类(28)
    C++(7)
    linux(8)
    SLAM(8)
    视觉Slam十四讲课后编程习题
    数据结构(5)
    随笔档案(28)
    2018年3月 (3)
    2018年2月 (2)
    2018年1月 (12)
    2017年11月 (1)
    2017年10月 (8)
    2017年8月 (2)
    积分与排名
    积分 - 14019
    排名 - 33761
    最新评论
11. Re:视觉slam十四讲第七章课后习题7
    博主，你好，未把空间点考虑进来是高斯牛顿法，如果把你上述程序仍用高斯牛顿法，发现求解的结果相去甚远。
    –我心永恒1994
12. Re:视觉slam十四讲第七章课后习题7
    @灰色的石头感谢博主的解答,感谢博主的博客内容…
    –小水一升
13. Re:视觉slam十四讲第七章课后习题7
    @小水一升恩 对的…
    –灰色的石头
14. Re:视觉slam十四讲第七章课后习题7
    @灰色的石头哦哦,我想我应该是明白了,一元边(ICP)提取的空间点的信息是用来计算误差e(3D点之间的),从而来优化pose的,只有一个优化类型. 二元边误差是重投影误差(像素平面的),把3D点和位…
    –小水一升
15. Re:视觉slam十四讲第七章课后习题7
    @小水一升并不是你理解的那样，一元边与二元边的区别是边链接节点类型的个数，比如一元边优化pose那么内部的只有关于pose的雅克比矩阵，但是对于二元边，优化过程中把空间点和pose都当做节点，然后内部…
    –灰色的石头
    阅读排行榜
16. ubuntu16.04+eigen3安装(8325)
17. ubuontu16.04安装Opencv库引发的find_package()错误信息处理及其简单使用(2717)
18. ubuntu16.04+Pangolin安装(1219)
19. (笔记)：初始化列表之初始化顺序(762)
20. Sophus库CMakeLists.txt内容详解笔记(686)
    评论排行榜
21. 视觉slam十四讲第七章课后习题7(6)
    推荐排行榜
22. ubuontu16.04安装Opencv库引发的find_package()错误信息处理及其简单使用(2)
23. Sopus库中FindEigen3.cmake内容详解笔记(1)
24. （原创）遗传算法C++实现(1)
    Copyright ©2018 灰色的石头

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法¹ 功能；
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目
  • 项目
    • 项目

1. 项目1
2. 项目2
3. 项目3

• 计划任务
• 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	'Isn't this fun?'	‘Isn’t this fun?’
Quotes	"Isn't this fun?"	“Isn’t this fun?”
Dashes	-- is en-dash, --- is em-dash	– is en-dash, — is em-dash

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

如何创建一个注脚

一个具有注脚的文本。²

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过欧拉积分

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

• 关于 甘特图 语法，参考 这儿,

UML 图表

可以使用UML图表进行渲染。 Mermaid. 例如下面产生的一个序列图：:

这将产生一个流程图。:

• 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart的流程图：

• 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件或者.html文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

---

1. mermaid语法说明 ↩︎

2. 注脚的解释 ↩︎