標題的自動編號
關于在哪里放置這些CSS,請按照添加自定義CSS。
此CSS片段會自動為文章中的所有標題添加編號,如下所示:

如何使用:
將以下內容添加到主題文件夾下的base.user.css或[theme] .user.css中。
/** initialize css counter */
#write {
counter-reset: h1
}
h1 {
counter-reset: h2
}
h2 {
counter-reset: h3
}
h3 {
counter-reset: h4
}
h4 {
counter-reset: h5
}
h5 {
counter-reset: h6
}
/** put counter result into headings */
#write h1:before {
counter-increment: h1;
content: counter(h1) ". "
}
#write h2:before {
counter-increment: h2;
content: counter(h1) "." counter(h2) ". "
}
#write h3:before,
h3.md-focus.md-heading:before /** override the default style for focused headings */ {
counter-increment: h3;
content: counter(h1) "." counter(h2) "." counter(h3) ". "
}
#write h4:before,
h4.md-focus.md-heading:before {
counter-increment: h4;
content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) ". "
}
#write h5:before,
h5.md-focus.md-heading:before {
counter-increment: h5;
content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) ". "
}
#write h6:before,
h6.md-focus.md-heading:before {
counter-increment: h6;
content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) "." counter(h6) ". "
}
/** override the default style for focused headings */
#write>h3.md-focus:before,
#write>h4.md-focus:before,
#write>h5.md-focus:before,
#write>h6.md-focus:before,
h3.md-focus:before,
h4.md-focus:before,
h5.md-focus:before,
h6.md-focus:before {
color: inherit;
border: inherit;
border-radius: inherit;
position: inherit;
left:initial;
float: none;
top:initial;
font-size: inherit;
padding-left: inherit;
padding-right: inherit;
vertical-align: inherit;
font-weight: inherit;
line-height: inherit;
}
自動編號TOC
如果您想要TOC實體也自動編號,您可以嘗試由Typora用戶發(fā)布的http://pastebin.com/NYugSbXk。
自動編號大綱面板。
可折疊大綱面板編號,并嘗試https://pastebin.com/XmYgBbaz。
代碼塊樣式/主題
關于在哪里放置這些CSS,請按照添加自定義CSS。
Typora使用CodeMirror在代碼圍欄中突出顯示語法。Typora中的代碼圍欄cm-s-inner用作其主題類。
要將CodeMirror主題移植到Typora中,例如material.css,您可以:
- 復制并粘貼到主題文件夾中
base.user.css或[theme].user.css下,并將其CodeMirror主題類名替換cm-s-inner為,例如,將原始文件中類名.cm-s-material更改為.cm-s-inner。 - 在CodeMirror渲染之前,代碼圍欄具有類似的結構
<pre class="md-fences"></pre>。因此,還請將字體系列,顏色和背景等基本樣式應用到.md-fences選擇器中。
所以最終的CSS會是
/** ported from https://codemirror.net/theme/material.css **/
/*
Name: material
Author: Michael Kaminsky (http://github.com/mkaminsky11)
Original material color scheme by Mattia Astorino (https://github.com/equinusocio/material-theme)
*/
.cm-s-inner {
background-color: #263238;
color: rgba(233, 237, 237, 1);
}
.cm-s-inner .CodeMirror-gutters {
background: #263238;
color: rgb(83,127,126);
border: none;
}
.cm-s-inner .CodeMirror-guttermarker, .cm-s-inner .CodeMirror-guttermarker-subtle, .cm-s-inner .CodeMirror-linenumber { color: rgb(83,127,126); }
.cm-s-inner .CodeMirror-cursor { border-left: 1px solid #f8f8f0; }
.cm-s-inner div.CodeMirror-selected { background: rgba(255, 255, 255, 0.15); }
.cm-s-inner.CodeMirror-focused div.CodeMirror-selected { background: rgba(255, 255, 255, 0.10); }
.cm-s-inner .CodeMirror-line::selection, .cm-s-inner .CodeMirror-line > span::selection, .cm-s-inner .CodeMirror-line > span > span::selection { background: rgba(255, 255, 255, 0.10); }
.cm-s-inner .CodeMirror-line::-moz-selection, .cm-s-inner .CodeMirror-line > span::-moz-selection, .cm-s-inner .CodeMirror-line > span > span::-moz-selection { background: rgba(255, 255, 255, 0.10); }
.cm-s-inner .CodeMirror-activeline-background { background: rgba(0, 0, 0, 0); }
.cm-s-inner .cm-keyword { color: rgba(199, 146, 234, 1); }
.cm-s-inner .cm-operator { color: rgba(233, 237, 237, 1); }
.cm-s-inner .cm-variable-2 { color: #80CBC4; }
.cm-s-inner .cm-variable-3 { color: #82B1FF; }
.cm-s-inner .cm-builtin { color: #DECB6B; }
.cm-s-inner .cm-atom { color: #F77669; }
.cm-s-inner .cm-number { color: #F77669; }
.cm-s-inner .cm-def { color: rgba(233, 237, 237, 1); }
.cm-s-inner .cm-string { color: #C3E88D; }
.cm-s-inner .cm-string-2 { color: #80CBC4; }
.cm-s-inner .cm-comment { color: #546E7A; }
.cm-s-inner .cm-variable { color: #82B1FF; }
.cm-s-inner .cm-tag { color: #80CBC4; }
.cm-s-inner .cm-meta { color: #80CBC4; }
.cm-s-inner .cm-attribute { color: #FFCB6B; }
.cm-s-inner .cm-property { color: #80CBAE; }
.cm-s-inner .cm-qualifier { color: #DECB6B; }
.cm-s-inner .cm-variable-3 { color: #DECB6B; }
.cm-s-inner .cm-tag { color: rgba(255, 83, 112, 1); }
.cm-s-inner .cm-error {
color: rgba(255, 255, 255, 1.0);
background-color: #EC5F67;
}
.cm-s-inner .CodeMirror-matchingbracket {
text-decoration: underline;
color: white !important;
}
/**apply to code fences with plan text**/
.md-fences {
background-color: #263238;
color: rgba(233, 237, 237, 1);
border: none;
}
.md-fences .code-tooltip {
background-color: #263238;
}

您也可以按照上面的示例編寫自己的CSS樣式以進行語法突出顯示。
請注意,cm-s-inner這僅適用于代碼圍欄,不會影響源代碼模式中的markdown語法指示燈。并非所有CSS屬性都將應用于源代碼模式中的代碼柵欄。
自定義字體
關于在哪里放置這些CSS,請按照添加自定義CSS。
Typora中的自定義字體由CSS設置。例如,base.user.css在主題文件夾下追加以下內容
body {
font-family: Courier;
}
將覆蓋當前主題中的字體設置,并應用系統(tǒng)字體Courier,并使編輯區(qū)域如下所示:

您還可以使用Web字體,例如:
@import url(https://fonts.googleapis.com/css?family=Oxygen);
body {
font-family: 'Oxygen', sans-serif;
}
但是為了在加載時使字體更快或在無法訪問互聯(lián)網(wǎng)時使用它,我們建議您下載它并放在Typora的主題文件夾下。
例如,如果您從谷歌字體下載woff2文件并將它們放在[typora-theme-folder]/fonts目錄下,那么您可以使用CSS,如:
/* latin */
@font-face {
font-family: 'Oxygen';
font-style: normal;
font-weight: 400;
src: local('Oxygen'), local('Oxygen-Regular'),url('./fonts/Oxygen400.woff2') format('woff2');
}
/* latin */
@font-face {
font-family: 'Oxygen';
font-style: normal;
font-weight: 700;
src: local('Oxygen Bold'), local('Oxygen-Bold'), url('./fonts/Oxygen700.woff2') format('woff2');
}
body {
font-family: 'Oxygen', sans-serif;
}
應用字體。
更改字體大小
更改字體大小的更快捷方法是在首選項面板中執(zhí)行此操作。在macOS上,“字體大小”位于首選項面板的“常規(guī)”部分。在Window / Linux上,它位于“Appearance”部分下,您還可以使用press Ctrl+F在首選項面板中搜索它。
此選項需要您使用的主題支持。如果您正在制作主題css,請使用rem字體單位確保此選項有效。

換背景
下面的一些CSS樣式適用于最新版本的Typora(在macOS上> = 0.9.9.6,在Windows上> = 0.9.13)。關于在哪里放置這些CSS,請按照添加自定義CSS。
就個人而言,我不建議用戶為文本編輯器設置背景,但如果你仍然想要這樣,你可以按照這篇文章做。
例如,為Typora添加筆記本背景。圖像從此處拍攝,并復制到Typora的主題文件夾下。
CSS代碼如下:
content {
background: url(./fzm-seamless.notebook.texture-14.png);
background-repeat: repeat;
}
#write {
padding-left: 120px; /*adjust writing area position*/
}
body {
background: #F3F3F3;
/*Please set this background color as close to the background image as possible.
titlebar for seamless window on macOS will use this background color.
typora for Win/Linux will use this to judge whether typora is in dark mode or light mode*/
}
/**Other css may needed to adjust UI components**/
結果如下:

另一個例子:

sscontent {
background-image: url(http://localhost:4000/media/background/crashed_ship_by_hiddenvortexdesigns-da57nk8.jpg);
background-repeat: repeat;
background-position: -52px;
}
#write {
margin-top: 24px;
background-color: rgba(255, 255, 255, 0.68);
margin-bottom: 24px;
min-height: calc(100% - 48px);
}
body {
background-color: #8F9D9A;
}
/**Other CSS to adjuest UI components*/
添加自定義CSS
此功能要求Windows上的Typora晚于0.9.12或macOS上的0.9.9.5.1
打開主題文件夾
打開首選項面板,然后單擊“外觀”部分下名為“打開主題文件夾”的按鈕,將在Finder /資源管理器中打開Typora的主題文件夾。
您可以在此處添加自定義主題(將有其他文檔介紹如何查找/安裝/編寫主題)。
但有時,您可能只想修改CSS,如更改字體或增加書寫區(qū)域,并將其應用于所有主題或當前主題而無需編寫全新的主題文件,本文檔將向您展示操作方法。
將自定義CSS附加到所有主題或其他主題
Typora將按以下順序加載CSS文件:
- Typora的基本款式。
- 當前主題的CSS。
- 主題文件夾下
base.user.css。 - 在主題文件夾下
{current-theme}.user.css。如果您選擇Github作為主題,那么github.user.css也將加載。
如果它們不存在,您可以在主題文件夾下創(chuàng)建base.user.css和{current-theme}.user.css。
如果要更改CSS樣式并將其應用于所有主題,則應修改base.user.css并附加自己的CSS,因此無論選擇何種主題,您的CSS樣式仍將加載并應用。
如果要修改特定主題的某些CSS,例如“新聞紙”,則可以創(chuàng)建newsprint.user.css并附加所需的CSS。我們不建議您直接修改主題文件的原因如下:
- 安裝Typora后可用的默認主題可能會在您更新Typora時同時更新。默認主題的更新邏輯只是:新版本的主題文件替換主題文件夾下的現(xiàn)有主題文件,因此如果將Typora更新為默認CSS文件,則修改后的修改可能會消失。
- 其他人開發(fā)的主題也可能在未來發(fā)生變化。如果他們更改了他們的CSS文件,您可以用舊文件替換他們的新文件,而不必擔心。如果將它們放在其他文件(
{current-theme}.user.css)中,您的修改將會消失。
但是如果你使用自己的CSS主題,那么直接修改它也行。
注意: {current-theme}.user.css中的{current-theme}應該(區(qū)分大小寫)與當前主題的文件名部分相同。例如,“GitHub”主題的CSS文件是github.css,因此文件名部分是“github”而不是“Github”。
調試CSS
您可以打開Chrome / Safari DevTools來調試元素樣式。
- 在macOS上,您可以打開
Safari,并從Develop- >your devide name- >Typora- >Typora菜單項打開DevTools 。 - 在Windows / Linux上,您可以從
View- >Toggle DevTools菜單項打開DevTools 。
打開Sublime(macOS)md
感謝Asoul,他創(chuàng)建了一個sublime插件,允許用戶在macOS上從Sublime 2/3打開Typora中的當前文件。

安裝說明
包安裝程序
- 安裝Sublime Package Control
- 從命令選項板中選擇“包控制:安裝包”(
super+shift+p) - 找到“Typora.app Markdown”并選擇
用法
選擇的視圖包含您要在標記中預覽的文件:
命令調色板:
- 從命令選項板中選擇“Markdown:使用Typora.app打開”(
super+shift+p)
菜單:
- 選擇工具→使用Typora打開
控制TOC層級
關于在哪里放置這些CSS,請按照添加自定義CSS。
在Typora [TOC]中將生成“目錄”,默認情況下它將顯示h1~h6的標題。
例如,要隱藏低級標題h6,您可以附加CSS:
.md-toc-h6 {
display: none;
}
在對焦模式下更改樣式
啟用聚焦模式時,<body>dom將具有類on-focus-mode,聚焦塊級元素將具有類md-focus。
可以包含md-focus類的塊是不能包含子塊的塊,并且將包含一個md-end-block類。例如,<blockquote>可以包含子塊<p>,因此它沒有md-end-block類,而h1具有該類。md-focus-containerclass將適用于li包含.md-focus塊的類。
所以我們可以在焦點模式下改變樣式,如:
/*Following are LESS code for better css structure*/
.on-focus-mode {
/* under focus mode*/
.md-end-block:not(.md-focus):not(.md-focus-container) {
* {
/* use color close to background for un-focused block */
color: #C8C8C8 !important;
}
img{
/* make img and element less attractive */
opacity: 50%;
}
}
.task-list-item:not(.md-focus-container)>input {
/* make the check mark on task list less attractive*/
opacity: 50%;
}
.md-fences.md-focus .CodeMirror-code>*:not(.CodeMirror-activeline) *,
.CodeMirror.cm-s-inner:not(.CodeMirror-focused) * {
/*lines in unfocused code fences, and unfocused lines in focused code fence*/
color: #C8C8C8 !important;
}
li[cid]:not(.md-focus-container) {
color: #C8C8C8 !important;
}
#typora-source .CodeMirror-code>*:not(.CodeMirror-activeline) * {
/*source code mode under focus mode*/
color: #C8C8C8 !important;
}
.md-focus,
.md-focus-container {
/* for text in current focused block */
color: #111;
}
}
添加搜索服務
用戶可以添加自定義搜索引擎以擴展上下文菜單中顯示的功能。

蘋果系統(tǒng)
在大多數(shù)應用程序的上下文菜單中,系統(tǒng)范圍內更改可用搜索引擎。你會在這里找到設置:

Windows
(需要Typora≥v0.9.16)
- 在Typora中打開
Menu→Preference,然后單擊“打開高級設置”。

從打開的“文件瀏覽” 打開并編輯
conf.user.json。如果沒有這樣的文件,請創(chuàng)建一個。-
修改或設置以下配置到
conf.user.json文件中,%s將代表所選文本。例如:"searchService": [ ["Search with Google", "https://google.com/search?q=%s"], ["Translate", "http://translate.google.com/?source=osdd#auto|auto|%s"] ["Search with Wikipedia", "https://en.wikipedia.org/wiki/Special:Search/%s"] ]注意:默認配置是:
"searchService": [ ["Search with Google", "https://google.com/search?q=%s"], ] 重啟Typora,選項
searchService將在上下文菜單中提供。
Shell或Cmd中使用
蘋果系統(tǒng)
您可以使用open -a typora xxx.md在Typora中打開目標markdown。如果Typora是.md文件的默認編輯器,那么open xxx.md就足夠了。
你也可以添加
alias typora="open -a typora"
在您的 .bash_profile 或其他配置文件中,您可以 typora xxx.md直接從shell /終端打開markdown文件。
Windows
如果將Typora設置為默認的markdown編輯器,則在cmd.exe中,.md直接輸入文件路徑將打開目標markdown文件。例如:.\example.md或start example.md
要將Typora設置為默認的markdown編輯器,您必須執(zhí)行以下操作:
- 選擇一個markdown文件
- 打開上下文菜單并選擇
- 單擊Properties,然后單擊Change buttong,如圖1所示
- 打開 - >選擇其他應用程序,如圖2所示
- 在“您想如何打開此文件 ”中選擇Typora或Typora Launcher ?并設置選中“ 始終使用此應用程序”以打開.md文件。
圖1 - 文件屬性窗口

圖2 - 應用程序選擇器窗口

Linux的
在Linux上安裝Typora后,用戶可以typora直接在終端中運行,例如:
typora ~/Document/test.md
調整圖像大小 圖片
Typora允許使用<img>標簽顯示圖像,也可用于調整圖像的大小。
例如,您可以指定標記的屬性width或height屬性<img>,或在其style屬性中設置寬度/高度:
<img src="https://www.google.com/doodles/kamma-rahbeks-241st-birthday" width="200px" />
<!--or-->
<img src="https://www.google.com/doodles/kamma-rahbeks-241st-birthday" style="height:200px" />
另一個常見的用例是,當您嘗試插入視網(wǎng)膜圖像,并希望將其縮放為“正確”大小時,您可以zoom在其style屬性中指定一個因子。
<img src="https://www.google.com/doodles/kamma-rahbeks-241st-birthday" style="zoom:50%" />
Typora可以理解和顯示上述語法。雖然您可以在其style屬性中設置其他css屬性,但在Typora編輯或預覽時會忽略它們,但可能會影響導出的HTML或PDF。
自動保存
macOS(Typora≥0.9.9.8.2)
在macOS上,操作系統(tǒng)將為基于文檔的應用程序(如Typora或TextEdit)安排自動保存操作。因此,“自動保存”始終作為系統(tǒng)功能啟用。

如果您希望Typora在退出或關閉時自動保存內容,而不彈出確認對話框,請取消選中復選框。
如果您希望Typora在重新啟動時恢復所有窗口/文檔,請取消選中復選框二。
Windows / Linux(Typora≥0.9.21)

您可以在首選項面板上啟用此功能。
默認情況下,文檔將每5分鐘保存一次。
如果要更改時間間隔,請單擊首選項面板上的“打開高級設置”按鈕,這將彈出一個名為的文件夾conf,然后編輯或創(chuàng)建一個名為的文件conf.user.json,并修改/添加以下設置:
{
"autoSaveTimer": 5 // Double, default is 5. The unit is "minute"
}
恢復未保存的草稿(Windows / Linux)
無論是否啟用“自動保存”選項,如果Typora退出或崩潰而未保存文件,或者您不小心保存了自己的文字,可以單擊“恢復未保存的草稿”按鈕以找到一些自動由Typora保存寫入的草稿。
這些備份草稿的文件名就像是{date}-{filename}.md,如果您的內容是新創(chuàng)建的,沒有文件路徑(即“無標題”),則該{filename}部分是自動生成的,通常是第一個標題或第一個句子。您可以找到并復制相應的備份文件以檢索您的部分文章。
版本控制和恢復
蘋果系統(tǒng)
在macOS上,Typora與操作系統(tǒng)支持的本機版本控制功能集成。
你可以簡單地選擇File> Revert To> Browse All Versions從主菜單瀏覽和回復到某個版本。更多細節(jié)可以在這里找到。

在Windows / Linux的
Windows 10還具有系統(tǒng)級別的版本控制支持(參考)。
在Window / Linux上的Typora不提供版本控制功能,但可以及時保存草稿以防止數(shù)據(jù)丟失,當Typora退出或崩潰而不保存文件,或者您意外地完成Typora而不保存您的文字。
您可以打開首選項面板,在“編輯器”部分下,單擊“恢復未保存的草稿”按鈕,找到由Typora自動保存的一些書寫草稿。

這些備份草稿的文件名就像是{date}-{filename}.md,如果您的內容是新創(chuàng)建的,沒有文件路徑(即“無標題”),則該{filename}部分是自動生成的,通常是第一個標題或第一個句子。您可以找到并復制相應的備份文件以檢索您的部分文章。
另外,Typora for Window / Linux具有自動保存功能。
RTL(從右到左)支持(實驗)
關于在哪里放置這些CSS,請按照添加自定義CSS。
這還沒有經(jīng)過全面測試,因為我不是RTL用戶,如果發(fā)現(xiàn)任何錯誤,請向hi@typora.io報告
添加以下自定義CSS:
#write {
direction: rtl;
}
任務列表 - 記錄待辦事項的簡便方法
基本用法
鍵入以下標記,它們將呈現(xiàn)為任務列表。
- [ ] This task is incomplete.
- [x] This task is completed.
快速更改任務狀態(tài)的方法
只需單擊當前任務列表的復選框,或 -
選擇Paragraph→ 下的菜單項Task Status,如果需要,請按照自定義鍵綁定指定快捷鍵。
“刪除”已完成的任務
您可能希望像這樣自動在已完成的任務上添加刪除線

這可以通過添加以下自定義CSS來實現(xiàn):
.task-list-done {
/* styles for completed tasks */
text-decoration: line-through;
}
.task-list-not-done {
/* styles for incomplete tasks */
}
您還可以添加CSS以使完成的任務列表減少對比度,因此您可以添加類似于color: #777更改選擇器的文本顏色的內容.task-list-done。
關于在哪里放置這些CSS,請按照添加自定義CSS。
自動配對

正常自動配對
打開首選項面板,并啟用“自動配對括號和引號”(上圖中的第1項)以打開正常自動對,其行為與大多數(shù)代碼編輯器相同。
自動配對擴展字符
如果啟用了“自動對常見的markdown語法”,自動對行為也將被延長到markdown的符號,像*,~,\``,或者_,如果“hightlight”,“內聯(lián)數(shù)學”,“上標”被啟用,自動配對的=,$并且^`也將被打開。
請注意,對于~,=和^,結束對不會被自動插入,但是當你選擇一個單詞,并輸入字符,如=,那么這個詞將被包圍=自動。
分頁
自動分頁
有時您可能希望導出為PDF,并在頂級標題上設置分頁符。
打開themes文件夾,然后根據(jù)要包含的內容編輯css
@media print {
h1 {
page-break-before: always;
}
h1:first-of-type {
page-break-before: avoid;
}
}
現(xiàn)在導出時,將在每個h1元素之前創(chuàng)建一個新頁面,第一個元素除外。
強制分頁
要在文檔上插入強制分頁<div style="page-break-after: always;"></div>符,您可以在編寫時嘗試輸入HTML 。
嚴格模式
你可以啟用嚴格模式告訴Typora 更嚴格地遵循GFM的規(guī)范。如果希望解析器更具“容錯能力”,可以禁用它。
嚴格的模式
在嚴格模式下,如果要輸入標題,則必須在#字符后面加上空格(例如,·代表一個空格):
| Markdown來源 | 嚴格模式結果 | 沒有嚴格模式的結果 |
|---|---|---|
###Header |
###header | header |
###·Header |
header | header |
在嚴格模式下,如果要在列表項中創(chuàng)建新塊/段落,則必須輸入足夠的空格縮進以使新段落與其前一段嚴格對齊,例如(·表示一個空格):
| 嚴格模式 | 非嚴格模式 |
|---|---|
1.·aaa ··bbb // not in same list ``1.·aaa ···bbb // in same list ``10.·aaa ··1.·ccc // not a sub list ``10.·aaa ····1.·ccc // a sub list |
1.·aaa ··bbb // in same list ``1.·aaa ···bbb // in same list ``10.·aaa ··1.·ccc // a sub list ``10.·aaa ··· 1.·ccc // a sub list |
啟用/禁用嚴格模式
可以在Preference Panel→ Markdown部分切換此選項。重新啟動Typora后將應用該選項。
改變書寫區(qū)域的寬度
下面的一些CSS樣式適用于最新版本的Typora(在macOS上> = 0.9.9.6,在Windows上> = 0.9.13)。*
關于在哪里放置這些CSS,請按照添加自定義CSS。
CSS示例:
#write {
max-width: 1800px; /*adjust writing area position*/
}
您還可以使用其他css樣式padding-left或padding-right調整書寫區(qū)域。
要更改源代碼模式的寬度:
#typora-source .CodeMirror-lines {
max-width: auto; /*or 1000px*/
}
使用Typora / Markdown中的鏈接
基本語法
-
超鏈接
[Link Text](link-address) [Link Text](link-address "optional title")http://對于這種類型的語法,不能忽略類似的協(xié)議。 -
參考鏈接
[Link Text][Ref] [Ref]: link-address "optional title"或者,它可以縮短為
[Ref][] [Ref]: link-addresshttp://對于這種類型的語法,不能忽略類似的協(xié)議。 -
自動鏈接
<http://typora.io> -
自動網(wǎng)址:Typora可以自動檢測markdown中的網(wǎng)址鏈接,并將其呈現(xiàn)為網(wǎng)址鏈接,但請注意其他markdown引擎可能不支持此功能。
This is a link: http://typora.io
對于指向網(wǎng)站的鏈接,我們建議您不要忽略像https://或http://之類的URL協(xié)議,或者在導出/發(fā)布之后它可能是Typora或其他markdown引擎的相關鏈接。
鏈接到本地文件
您可以使用寫入相對或絕對路徑作為本地文件的鏈接地址,可以省略類似(.md)的擴展名,例如:
[Readme1](Readme1.md)
[Readme2](../Docs/Readme2.markdown)
[Readme3](Readme3)
[Readme4](/User/root/Docs/Readme1.md)
[Readme4](C:/Develop/Docs/Readme1.md)
[Readme4](file:///User/root/Docs/Readme1.md)
請注意,對于相對鏈接地址,當根據(jù)Markdown規(guī)范導出為HTML時,它不會轉換為真正的絕對文件路徑。
內部鏈接
您可以使用#創(chuàng)建標記文件中任何標題的鏈接,例如:
# This is a title
...
...
...
A [link](#this-is-a-title) to jump towards target header
在Typora中打開鏈接
您可以在Typora中的鏈接上使用command+click(macOS)或ctrl+click(Linux / Windows)跳轉到目標標題,或在Typora中打開它們,或在相關應用程序中打開它們。
常問問題
錯誤“無法打開位置/abc.com,您的意思是http://abc.com嗎?”在我嘗試打開鏈接時顯示
如果要鏈接到本地文件abd.com,請確保路徑正確。
如果要創(chuàng)建指向網(wǎng)站“abc.com”的鏈接,則需要使用URL方案或協(xié)議,例如使用[link](http://abc.com)。
有時,如果使用autolink(<www.google.com>)或auto URL(www.google.com),則可以省略協(xié)議,但是這會在不同的Markdown編輯器/引擎中規(guī)定變量,因此我們建議您不要在任何情況下忽略協(xié)議,以減少兼容性問題。
空白和換行
Typora中的推薦做法
在Markdown中,換行符令人困惑,我們的建議是:
- 使用Typora的默認設置。
- 用Typora的混合視圖寫。
- 按下
Enter鍵插入新的段落,并避免插入新行。 - 如果確實需要單個硬換行符,請使用以下語法:
<br/>。
單個換行
單個換行在不同的Markdown引擎中的解析方式不同,CommonMark只會忽略它,換句話說,如果你寫:
line 1
line 2
它將呈現(xiàn)為
第1行第2行
但是其他markdown引擎可能會選擇保留它(比如GitHub中的問題輸入框),或提供是否保留它的選項。
在Typora中,我們提供了是否在首選項面板中保留它的選項,您可以選擇快速從菜單欄寫入時的行為。默認情況下,Typora將在編輯視圖中保留換行符,并在打印或導出時忽略它們。您可以在首選項面板中更改此選項。
空白
連續(xù)空格類似于單個換行,大多數(shù)Markdown引擎會忽略它們,例如CommonMark,
Four whietspace in between
將被轉換為
<p>Four whitespace in between</p>
而你只會看到
中間有四個空格
默認情況下,Typora將在編輯視圖中保留連續(xù)空格,并在打印或導出時忽略它們。您可以在首選項面板中更改此選項。
如果你想插入其他markdown引擎支持的連續(xù)空格,你可以
- 轉義空白,在每個空格之前輸入
\ - 使用HTML實體
&nbps;。
Typora中的Enter 鍵
在Markdown中,兩個換行符意味著在Typora中創(chuàng)建一個新段落,當您按下Enter鍵時,會創(chuàng)建一個新段落,如果切換到源代碼模式,則會插入兩個換行符,例如,
第1段
第2段
是
paragraph 1
(empty line)
paragraph 2
您可以通過按Shift+ Enter鍵在編輯視圖中顯式插入單個換行符。
markdown硬換行
Markdown提供了插入單個硬換行符的方法:
- 插入兩個空格和一個換行符。
-
<br/>直接插入HTML標記。
幾乎所有Markdown引擎都會將它們解析為輸出中的硬換行符。
在Typora中更改相關設置
我們在菜單欄中提供相關設置Preference Panel或Edit- > Whitespace and Line Breaks。
智能標點符號(SmartyPants)
注意:YAML / code / math塊或源代碼模式中都會忽略
Smart Quotes和Smart Dashes。
智能引號
您可以從菜單欄或首選項面板中找到Smart Quotes選項。啟用后,Typora將'和"轉換向彎引號。例如,如果您輸入:
"It's a 'word' in a quoted sentence."
它會變成:
“It’s a ‘word’ in a quoted sentence.”
在Windows / Linux版本中,您可以在“首選項”面板中找到更多引號對模式,例如“?abc?”等。
在MacOS版本,你可以設置在引號模式System Preferences→Keyboard→Text。如果更改,Typora將需要重新啟動才能應用它。
智能破折號
您可以從菜單欄或首選項面板中找到Smart Dashes選項。啟用后,Typora將--和---轉換為–和—,...將被轉換為…。
注意:在MacOS中,如果選擇“輸入轉換”,
--和---都將被轉換成—,要輸入--請alt+-`將其輸入。這似乎是一個macOS規(guī)范,Typora也跟隨macOS。
轉義引號和破折號
您可以使用\"和\-轉義引號和短劃線以防止它們進行轉換。
“轉換輸入”和“轉換時轉換”
這些選項控制標點符號的轉換方式。
啟用“ 在輸入時轉換”時,會在用戶鍵入時立即轉換引號和短劃線,并且轉換后的內容將保存在Markdown源代碼中。例如,如果啟用了智能破折號,并且在用戶輸入...之后,將進入…編輯/預覽視圖和源代碼。用戶可以通過undo操作取消不正確的轉換。
啟用“ 在渲染時轉換”時,當用戶輸入ASCII引號和短劃線時,原始ASCII將保存在源模式中,但在編輯/預覽視圖中,Typora會將它們渲染為彎引號或unicode破折號。
當用戶在YAML /代碼/數(shù)學塊或源代碼模式下輸入時,兩者都忽略轉換。
在解析中重新映射Unicode標點符號
當智能破折號的“輸入時轉換上”啟用后,如果用戶輸入``將變成<!— comments —>,因為--被轉換。
為了防止這種情況,Typora引入了這個選項。啟用后,Typora會將markdown語法的unicode替代品重新映射為ASCII格式,例如:
| 輸入 | 解析為 |
|---|---|
<!— comments —> |
<!-- comment --> |
[圖片上傳失敗...(image-d8411c-1554297158859)] 或 [圖片上傳失敗...(image-d4d352-1554297158859)]
|
[圖片上傳失敗...(image-7e3b54-1554297158859)] |
— |
---(水平線) |
》 引用 |
> 引用 |
| ... |
如果您的IME(輸入法引擎)無法直接輸入ASCII標點,這也會有所幫助。
當在輸入時轉換啟用時,這個選項也將被自動啟用。
文字替換
Typora并不支持進一步文本替換規(guī)則(例如:->至→,或(C)到?)。要做這個:
- 在MacOS,我們建議您設置
System Preferences→Keyboard→Text。并在Typora的菜單中啟用“文本替換”。然后Typora可以使用您的文本替換規(guī)則。 - 在Windows / Linux上,我們建議您使用第三方應用程序來配置文本替換。您可以從此列表中進行選擇。
嵌入視頻,媒體或網(wǎng)頁內容
您可以使用<HTML>代碼在Typora中嵌入視頻/音頻或遠程Web內容。
目錄
視頻
您可以嵌入這樣的視頻:
<video src="xxx.mp4" />
或者將視頻文件拖放到Typora中,Typora會自動插入視頻。
Video路徑遵循與圖像相同的規(guī)則。因此,選項“盡可能使用相對路徑”和“圖像根路徑”也適用于<video>內容。
音頻
與<video>相同,您可以使用<audio>標簽來嵌入音頻:
<audio src="xxx.mp3" />
嵌入Web內容
有些網(wǎng)站允許您將其內容嵌入到其他網(wǎng)頁中,其中大部分支持<iframe>,Typora也支持這些網(wǎng)頁。您可以按照他們的“共享”頁面/對話框,將他們的代碼粘貼到Typora中,例如:
<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='//codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'>See the Pen <a >Fancy Animated SVG Menu</a> by Jean Gontijo (<a >@jeangontijo</a>) on <a >CodePen</a>.
</iframe>
這將成為
<iframe height="265" scrolling="no" title="花式動畫SVG菜單" src="http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2" frameborder="no" allowtransparency="true" allowfullscreen="true" style="color: rgb(0, 0, 0); font-family: Merriweather, "PT Serif", Georgia, "Times New Roman", STSong, serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 300; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 800px;"></iframe>
有些網(wǎng)站只提供基于Javascript的嵌入代碼,而不是<iframe>剪輯,例如:
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Sunsets don't get much better than this one over <a >@GrandTetonNPS</a>. <a >#nature</a> <a >#sunset</a> <a >pic.twitter.com/YuKy2rcjyU</a></p>— US Department of the Interior (@Interior) <a >May 5, 2014</a></blockquote>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
Typora僅支持一些基于腳本的共享代碼,這些內容/腳本也將在沙箱iframe中運行,無法訪問本地文件和寫入內容。
我們可以考慮允許用戶在將來的更新中為此類配置“ 白名單 ”。
目前只有macOS版本支持嵌入PDF文檔:
<iframe src="https://pdfobject.com/pdf/sample-3pp.pdf" style="height=800px;" />
黑暗模式
MacOS Mojave推出了“Dark Mode”,Typora也完全支持它。你可以用它來:
- 在macOS Mojave中打開“黑暗模式”
- 在Typora中選擇一個黑暗主題。

啟動選項
啟動typora時,您可以將默認操作設置為:
- 打開新文件
- 恢復上次關閉的文件夾
- 恢復上次關閉的文件和文件夾
- 打開自定義文件夾。
可以在首選項面板中設置此選項:

字數(shù)
字數(shù)統(tǒng)計顯示在狀態(tài)欄(Windows / Linux)或標題欄上(懸停時為macOS)。Typora還會計算行數(shù),字符和估計的閱讀時間。您可以單擊“字數(shù)”按鈕,在彈出式面板中顯示所有這些統(tǒng)計信息。

您可以通過選擇字數(shù)統(tǒng)計面板中的相應項來更改默認計數(shù)單位。
選擇一系列文本時,所選文本的字數(shù)或字符數(shù)將顯示在字數(shù)統(tǒng)計按鈕中。
字數(shù)不包括用于格式目的的markdown語法,例如list bullet( - ),而字符數(shù)計算它們。
對于中文文本,一個漢字算一個字。
對焦模式和打字機模式
對焦模式
啟用“對焦模式”時,Typora將淡出除當前行/塊之外的其他內容。您可以從view菜單中打開/關閉“對焦模式” 。
同 Focus Mode
|
無 Focus Mode
|
|---|---|
![]() Screen Shot 2019-01-05 at 15.50.26.png
|
![]() Screen Shot 2019-01-05 at 15.50.48.png
|
打字機模式
打字機模式模仿機械打字機的行為 - 它滾動文章以在打字時保持當前插入符不變。
您可以從view菜單中打開/關閉打字機模式。
默認情況下,即使您通過鼠標單擊更改選擇,它也始終將插入符號保留在窗口中間。如果您只想在鍵入時使用固定滾動,則可以從preferences panel→ 禁用此行為Always keep caret in middle of screen\nwhen typewriter mode is enabled。
復制和粘貼
剪貼板如何工作
我們先來討論剪貼板格式。剪貼板格式用于描述剪貼板上放置的數(shù)據(jù)類型。
當您在Typora中復制內容時,在大多數(shù)情況下,Typora會將所選內容轉換為不同的格式,包括HTML,Rich Format(RTF),純文本,并將它們同時存儲在剪貼板中。然后,當您粘貼到不同的應用程序時,將根據(jù)目標應用程序的邏輯選擇正確的格式。例如,如果您粘貼到Gmail中,則會粘貼HTML格式的內容,而如果您粘貼到源代碼編輯器(如Sublime)中,則會粘貼純文本格式的內容。因此,與大多數(shù)其他Markdown編輯器不同,Typora不會明確提供“以HTML格式復制”或“復制為RTF”等菜單操作,當您在Typora中復制時,這些格式已經(jīng)被復制。
通常,您可以按下Command/Ctrl+Shift+V將內容作為純文本(或“匹配樣式”)粘貼到其他應用程序中。
同樣,當您將內容粘貼到Typora時,首先,Typora在剪貼板中選擇HTML格式并將其轉換為Markdown。如果未找到HTML內容,typora會將內容粘貼為純文本或Markdown源。在源代碼模式下,始終選擇純文本格式。
粘貼為純文本
“粘貼為純文本”與Typora中的“粘貼為markdown源”具有相同的含義。您可以使用快捷鍵Command/Ctrl+Shift+V。
復制為Markdown
如果您復制的內容看起來像“ 男孩 ”并粘貼到純文本編輯器,如Notepad.exe或VSCode,
默認情況下將粘貼“男孩”,而選擇“復制為markdown”時將粘貼“男孩”。這個快捷鍵是Command/Ctrl+Shift+C。
默認復制行為
如果您與豐富的編輯器(如郵件客戶端或Word)以及代碼編輯器或IDE一起工作,您可能希望 - 在Typora中復制內容,然后:
- 粘貼到富編輯器時粘貼了豐富的內容
- 粘貼到代碼編輯器時粘貼Markdown源代碼
這在其他markdown編輯器中很難實現(xiàn),但在Typora中完全可能。
要實現(xiàn)此目的,請打開首選項面板的“編輯器”選項卡/部分,然后為“默認復制行為”啟用“將標記源復制為純文本”。

在Typora中復制內容

粘貼到Gmail中(將粘貼具有豐富樣式的內容)

粘貼到VSCode(將粘貼Markdown源代碼)
沒有主題樣式的復制
默認情況下,從其他富文本編輯器復制內容將包括樣式,包括字體,行高,顏色等。您可能只想復制具有基本格式或“語義文本”的內容。
例如,您可能希望復制<strong>text</strong>,而不是具有在每個主題中定義的特定字體系列,字體大小,顏色...樣式的“文本”,在這種情況下,“首選沒有主題樣式的復制”是首選。

復制沒有主題樣式并粘貼到頁面
為了更好地在Typora和其他應用程序之間移動內容,請使用“導出”功能而不是復制和粘貼。
復制為HTML代碼
當選擇動作時,Typora會將所選部分轉換為HTML,并將HMTL源代碼放入剪貼板的“純文本”格式。對于開發(fā)人員,您可能有機會在源代碼編輯器中編輯HTML文件,此菜單操作可幫助您將Typora中的內容復制到HTML源代碼中。

復制為HTML代碼并粘貼到VSCode中
使用移動設備和其他設備
數(shù)據(jù)同步
Typora以Markdown格式存儲文件,這只是純文本。因此,您可以使用任何第三方同步工具(例如iCloud Drive,Google Drive,OneDrive,Dropbox等)跨設備同步這些文件。
移動支持
我們目前專注于Typora的桌面版本,因此不久將不會有Typora的移動版本。
要在Mobile上編輯文件,您可以選擇支持iCould Drive或其他第三個云同步/存儲工具的任何Markdown編輯器,例如
- Pretext
- MWeb
- 1Writer
- ByWord
- iA Writer
- Editorial
- ...或在App Store或Google Play中搜索“Markdown”。

