1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/ravenq-markdown-it-vue

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
README_CN.md 7.8 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 13.03.2025 05:08 59e49b9

markdown-it-vue

Статус сборки

Библиотека компонентов Vue для работы с markdown. markdown-it-vue — это богатый набор компонентов для работы с markdown в Vue, использует markdown-it как движок парсинга данных markdown, объединяет множество плагинов markdown-it и имеет встроенные функциональные плагины, поддерживающие общие возможности, такие как GFM TOC, GFM стиль, эмодзи и другие. Также поддерживает различные виджеты, такие как mermaid charts, Echarts, flowchart.js и другие, а также поддерживает отображение математических формул в ASCII Math и LaTeX, а также поддерживает персонализированные сообщения об ошибках, предупреждениях и информационные сообщения.

Примеры онлайн

http://www.aqcoder.com/markdown Из-за известных причин может потребоваться использование прокси.

Установка

npm install markdown-it-vue

Основные характеристики

  • Контроль размера изображений и просмотр изображений
  • Официальный синтаксис markdown.
  • GFM TOC
  • GFM стиль
  • Эмодзи
  • Mermaid charts
  • Echarts
  • Flowcharts.js
  • Подстрочные и надстрочные знаки
  • AsciiMath
  • Сообщения об ошибках, предупреждениях и информационные сообщения

Используемые плагины

  • markdown-it
  • markdown-it-emoji
  • markdown-it-sub
  • markdown-it-sup
  • markdown-it-footnote
  • markdown-it-deflist
  • markdown-it-abbr
  • markdown-it-ins
  • markdown-it-mark
  • markdown-it-katex
  • markdown-it-task-lists
  • markdown-it-icons
  • markdown-it-highlight
  • markdown-it-latex
  • markdown-it-container
  • markdown-it-github-toc
  • markdown-it-source-map
  • markdown-it-link-attributes Встроенные плагины:
  • markdown-it-image
  • markdown-it-font-awesome
  • markdown-it-link-attributes
  • markdown-it-highlight
  • markdown-it-plugin-echarts
  • markdown-it-plugin-mermaid
  • markdown-it-plugin-flowchart

Параметры markdown-it и его плагинов

Используйте options для указания параметров для markdown-it и его плагинов.

<markdown-it-vue class="md-body" :content="content" :options="options" />
options: {
  markdownIt: {
    linkify: true
  },
  linkAttributes: {
    attrs: {
      target: '_blank',
      rel: 'noopener'
    }
  }
}

Дополнительные параметры markdown-it см. в официальной документации: https://markdown-it.github.io/markdown-it/. По умолчанию используются следующие параметры плагинов:

{
  linkAttributes: {
    attrs: {
      target: '_blank',
      rel: 'noopener'
    }
  },
  katex: {
    throwOnError: false,
  }
}

Дополнительные настройки```json

errorColor: '#cc0000'


### Иконки
Используются иконки Font Awesome.

### Github TOC
Настройки таблиц содержаний:

```json
{
  tocFirstLevel: 2,
  tocLastLevel: 3,
  tocClassName: 'toc',
  anchorLinkSymbol: '',
  anchorLinkSpace: false,
  anchorClassName: 'anchor',
  anchorLinkSymbolClassName: 'octicon octicon-link'
}

Mermaid

Настройка темы Mermaid:

theme: 'default'

Изображения

Настройки выравнивания и просмотра изображений:

hAlign: 'left',
viewer: true

Подробное описание плагинов

Подробное описание плагинов доступно в официальной документации плагинов.

Настройка пользовательских плагинов

Вы можете добавить свой плагин в markdown-it-vue с помощью метода use.

this.$refs.myMarkdownItVue.use(MyMarkdownItPlugin)

Поддерживаемые языки для выделения синтаксиса

Для снижения размера пакета используется highlight.js, который поддерживает следующие языки программирования:

  • html
  • json
  • css
  • shell
  • bash
  • C
  • Java
  • Python
  • C++
  • C#
  • PHP
  • SQL
  • R
  • Swift
  • Go
  • MATLAB
  • Ruby
  • Perl
  • Objective-C
  • Rust
  • Dart
  • Delphi
  • D
  • Kotlin
  • Scala
  • SAS
  • Lisp
  • Lua
  • Ada
  • Fortran
  • PowerShell
  • VBScript
  • Vbscript-html
  • Groovy
  • Julia
  • Julia-repl
  • LabVIEW
  • Haskell
  • ActionScript
  • Scheme
  • TypeScript
  • F#
  • Prolog
  • Erlang

Если вам необходим язык, которого нет в этом списке, просьба отправить pull request.

Управление размерами изображений

Следующий синтаксис позволяет контролировать размеры изображений:

![Размер изображения](https://http://www.aqcoder.com/ravenq-qr.png=50x50)
![Размер изображения](https://http://www.aqcoder.com/ravenq-qr.png=x50)
![Размер изображения](https://http://www.aqcoder.com/ravenq-qr.png=50x)
```## Описание использования ECharts
Для уменьшения размера пакета используется только простой вариант ECharts (`echarts.simple`).

## Версия `markdown-it-vue-light`
<https://github.com/ravenq/markdown-it-vue/issues/24>

Для дальнейшего уменьшения размера пакета был удален плагин `mermaid`. В этой версии используется весь пакет `lodash`, что также увеличивает размер пакета.

Если вы не используете эти возможности часто, рекомендуется использовать эту упрощённую версию.

## Пример использования
```vue
<template>
  <div>
    <markdown-it-vue class="md-body" :content="content" />
  </div>
</template>

<script>
import MarkdownItVue from 'markdown-it-vue'
import 'markdown-it-vue/dist/markdown-it-vue.css'

export default {
  components: {
    MarkdownItVue
  },
  data() {
    return {
      content: '# ваш контент на markdown'
    }
  }
}
</script>

Пример использования упрощённой версии

<template>
  <div>
    <markdown-it-vue-light class="md-body" :content="content" />
  </div>
</template>

<script>
// ...
</script>
```javascript
import MarkdownItVueLight from 'markdown-it-vue/dist/markdown-it-vue-light.umd.min.js'
import 'markdown-it-vue/dist/markdown-it-vue-light.css'
export default {
  components: {
    MarkdownItVueLight
  },
  data() {
    return {
      content: '# ваш markdown контент'
    }
  }
}
</script>
## Пример скриншота
![](https://github.com/ravenq/markdown-it-vue/blob/master/doc/markdown-it-vue.png?raw=true)
## Лицензия
[MIT](https://github.com/ravenq/markdown-it-vue/blob/master/LICENSE)

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/ravenq-markdown-it-vue.git
git@api.gitlife.ru:oschina-mirror/ravenq-markdown-it-vue.git
oschina-mirror
ravenq-markdown-it-vue
ravenq-markdown-it-vue
master