什么是 Markdown wiki

Markdown 是一种方便记忆、书写的纯文本标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档:譬如您正在阅读的这份文档。它使用简单的符号标记不同的标题,分割不同的段落,粗体 或者 斜体 某些文字 还可以颜色变换 等等;

您可以使用 Cmd Markdown:

  • 整理知识,学习笔 记
  • 发布日记,杂文,所见所想
  • 撰写发布技术文稿(代码支持)
  • 撰写发布学术论文(LaTeX 公式支持)

作为Windows/Mac/Linux下强大的文本编辑器,st提供了对Markdown语言的支持。通过设置可实现 markdown 预览和转换功能。
而本文介绍的Markdown Preview支持Mathjax语法和目录自动生成。(Windows下)

安装Package Control

安装包控制扩展可以方便地为st添加拓展。
打开st,按下组合键Control + `,出现控制台,输入

1
2
3
4
5
import urllib2,os; pf='Package Control.sublime-package';
ipp = sublime.installed_packages_path(); os.makedirs( ipp ) if not os.path.exists(ipp) else None;
urllib2.install_opener( urllib2.build_opener( urllib2.ProxyHandler( )));
open( os.path.join( ipp, pf), 'wb' ).write( urllib2.urlopen( 'http://sublime.wbond.net/' +pf.replace( ' ','%20' )).read());
print( 'Please restart Sublime Text to finish installation')

当看到代码最后一行提示的时候说明安装成功,此时重启st,可在Preferences -> Package Settings看到Package Control。

安装markdown preview

按下键Ctrl+Shift+p调出命令面板,找到Package Control: install Pakage这一项。搜索markdown preview,点击安装。

关于编辑

按Ctrl + N 新建一个文档
按Ctrl + Shift + P
使用Markdown语法编辑文档
语法高亮,输入ssm 后回车(Set Syntax: Markdown)

关于使用

Markdown Preview较常用的功能是preview in browser和Export HTML in Sublime Text,前者可以在浏览器看到预览效果,后者可将markdown保存为html文件。
preview inbrowser据称是实时的,但是实践上还是需要在st保存,然后浏览器刷新才能看到新的效果,
好在markdown写得多的话也不需要每敲一行看一次效果。

在浏览器预览Markdown文档

按Ctrl + Shift + P
输入mp 后回车(Markdown Preview: current file in browser)
此时就可以在浏览器里看到刚才编辑的文档了;
若设置了快捷键,直接(alt+m/..)即可.

关于快捷键

st支持自定义快捷键,markdown preview默认没有快捷键,我们可以自己为preview in browser设置快捷键。
方法是在Preferences -> Key Bindings User打开的文件的中括号中添加以下代码(可在Key Bindings Default找到格式):
{ “keys”: [“alt+m”], “command”: “markdown_preview”, “args”: { “target”: “browser”} }
“alt+m”可设置为您自己喜欢的按键。
如果你这里没有看到目录而只是看到代码,说明简书不支持目录自动生成…

打印成pdf

将markdown转换为pdf应该有很多种方法的。可直接用谷歌浏览器虚拟打印功能生成。
利用Markdown Preview的Preview in Browser功能可以在浏览器上看到html效果。在页面右键->打印->另存为pdf->调节页边距即可将pdf文件下载下来。


参考链接:
1 使用Sublime Text 2 编辑Markdown
2 sublime text 2 下的Markdown写作
3 Markdown入门基础


静晴轩 ~ 晚晴幽草轩
个人微信公众号晚晴幽草轩;名字取自:“天意怜幽草,人间重晚晴”。
专注互联网开发(Web 大前端、快应用、小程序),以及分享优质网站、AI 应用、效率工具、心得感悟等内容。

文章目录
  1. 1. 什么是 Markdown wiki
  2. 2. 安装Package Control
  3. 3. 安装markdown preview
  4. 4. 关于编辑
  5. 5. 关于使用
  6. 6. 在浏览器预览Markdown文档
  7. 7. 关于快捷键
  8. 8. 打印成pdf