1 | # Quasar App Extension QMarkdown
|
2 |
|
3 | The QMarkdown app extension can do the following:
|
4 | 1. Automatically inject the `quasar-ui-qmarkdown` component using the Quasar CLI.
|
5 | 2. Modify webpack to allow importing of markdown (\*.md) files.
|
6 | 3. Modify webpack to allow importing of vue+markdown (\*.vmd) files.
|
7 |
|
8 | Remember, app extensions can _only_ be used with the Quasar CLI.
|
9 |
|
10 | [![npm](https://img.shields.io/npm/v/@quasar/quasar-app-extension-qmarkdown.svg?label=@quasar/quasar-app-extension-qmarkdown)](https://www.npmjs.com/package/quasar-app-extension-qmarkdown)
|
11 | [![npm](https://img.shields.io/npm/dt/@quasar/quasar-app-extension-qmarkdown.svg)](https://www.npmjs.com/package/@quasar/quasar-app-extension-qmarkdown)
|
12 |
|
13 | # Updating
|
14 | If you already have the app extension installed, you can use the Quasar CLI to automatically update it via:
|
15 | ```bash
|
16 | quasar upgrade -i
|
17 | ```
|
18 | If you are updating from a beta version, to v1.0.0, you will also need to do the following:
|
19 | ```bash
|
20 | quasar ext invoke @quasar/qmarkdown
|
21 | ```
|
22 | At which point you will be asked two questions about importing markdown (\*.md) and vue+markdown (\*.vmd) files.
|
23 |
|
24 | # New Install
|
25 | ```bash
|
26 | quasar ext add qmarkdown
|
27 | ```
|
28 | Quasar CLI will retrieve it from NPM and install the extension.
|
29 |
|
30 | ## Prompts
|
31 |
|
32 | When installing the QMarkdown app extension, you will be prompted with two questions:
|
33 |
|
34 | 1) "Do you want to be able to import markdown (*.md) files?"
|
35 |
|
36 | The default is `true` for the above question. It allows you to do this in your Quasar apps:
|
37 |
|
38 | ```js
|
39 | import markdown from '../examples/myMarkdownFile.md'
|
40 | ```
|
41 |
|
42 | You can now use the QMarkdown component to process the markdown file to be displayed on your page.
|
43 |
|
44 | 2) "Do you want to be able to import vue+markdown (*.vmd) files?"
|
45 |
|
46 | The default is `true` for the above question. It allows you to do this in your Quasar apps:
|
47 |
|
48 | ```js
|
49 | import vmd from '../examples/myVuePlusMarkdownFile.vmd'
|
50 |
|
51 | components: {
|
52 | myComponent: vmd
|
53 | }
|
54 | ```
|
55 |
|
56 | **vmd** files also allow you to provide front-matter as part of the processing. Be sure to read the documentation to understand how this works.
|
57 |
|
58 | # Uninstall
|
59 | ```bash
|
60 | quasar ext remove qmarkdown
|
61 | ```
|
62 |
|
63 | # Describe
|
64 | You can use `quasar describe QMarkdown` for the QMarkdown component
|
65 |
|
66 | # Demo Project
|
67 | Can be found [here](https://github.com/quasarframework/quasar-ui-qmarkdown/tree/master/demo).
|
68 |
|
69 |
|
70 | # Documentation
|
71 | Can be found [here](https://quasarframework.github.io/quasar-ui-qmarkdown/).
|
72 |
|
73 | # Live Demo
|
74 | Can be found [here](https://quasarframework.github.io/quasar-ui-qmarkdown/demo).
|
75 |
|
76 | # Donate
|
77 | If you appreciate the work that went into this project, please consider donating to [Quasar](https://donate.quasar.dev) or [Jeff](https://github.com/sponsors/hawkeye64).
|
78 |
|
79 | # License
|
80 | MIT (c) Jeff Galbraith <jeff@quasar.dev>
|