BookStack Code Mirror - website/blob - content/docs/user/markdown-editor.md

 1 +++
 2 title = "Markdown Editor"
 3 description = "Details on using the markdown editor in BookStack"
 4 date = "2017-07-28"
 5 type = "user-doc"
 6 +++
 7
 8 If you prefer to write in Markdown, the editor in BookStack can be changed at an instance level
 9 to use a markdown editor instead of the default WYSIWYG editor. The option to use Markdown is currently **not** a user setting but a global instance setting due to formatting differences between the two editors.
 10
 11 > Note that shifting to the markdown editor from the WYSIWYG editor may cause unintended side effects to existing content. This is due to the differences in the way the content is stored in the database.
 12
 13 ### Editor Shortcuts
 14
 15 The following shortcuts are available in the Markdown Editor:
 16
 17 <table>
 18   <thead>
 19     <tr>
 20       <th>Shortcut (Windows &amp; Linux/Mac)</th>
 21       <th>Description</th>
 22     </tr>
 23   </thead>
 24   <tbody>
 25     <tr>
 26       <td><code>Ctrl+S</code> / <code>Cmd+S</code></td>
 27       <td>Save Draft</td>
 28     </tr>
 29     <tr>
 30       <td><code>Ctrl+Enter</code> / <code>Cmd+Enter</code></td>
 31       <td>Save Page &amp; Continue</td>
 32     </tr>
 33     <tr>
 34       <td>
 35         <code>Ctrl+1</code> / <code>Cmd+1</code> <br>
 36         <code>Ctrl+2</code> / <code>Cmd+2</code> <br>
 37         <code>Ctrl+3</code> / <code>Cmd+3</code> <br>
 38         <code>Ctrl+4</code> / <code>Cmd+4</code>
 39       </td>
 40       <td>
 41         Header Large (h2)<br>
 42         Header Medium (h3)<br>
 43         Header Small (h4)<br>
 44         Header Tiny (h5)
 45       </td>
 46     </tr>
 47     <tr>
 48       <td><code>Ctrl+5</code> / <code>Cmd+5</code><br><code>Ctrl+D</code> / <code>Cmd+D</code></td>
 49       <td>Normal Paragraph</td>
 50     </tr>
 51     <tr>
 52       <td><code>Ctrl+6</code> / <code>Cmd+6</code><br><code>Ctrl+Q</code> / <code>Cmd+Q</code></td>
 53       <td>Blockquote</td>
 54     </tr>
 55     <tr>
 56       <td><code>Ctrl+7</code> / <code>Cmd+7</code><br><code>Ctrl+E</code> / <code>Cmd+E</code></td>
 57       <td>Code Block</td>
 58     </tr>
 59     <tr>
 60       <td><code>Ctrl+8</code> / <code>Cmd+8</code><br><code>Ctrl+Shift+E</code> / <code>Cmd+Shift+E</code></td>
 61       <td>Inline Code</td>
 62     </tr>
 63     <tr>
 64       <td><code>Ctrl+9</code> / <code>Cmd+9</code></td>
 65       <td>Callout (Info)</td>
 66     </tr>
 67     <tr>
 68       <td><code>Ctrl+K</code> / <code>Cmd+K</code></td>
 69       <td>Insert Link</td>
 70     </tr>
 71     <tr>
 72       <td><code>Ctrl+Shift+K</code> / <code>Cmd+Shift+K</code></td>
 73       <td>Show link selector</td>
 74     </tr>
 75     <tr>
 76       <td><code>Ctrl+Shift+I</code> / <code>Cmd+Shift+I</code></td>
 77       <td>Insert Image</td>
 78     </tr>
 79   </tbody>
 80 </table>