Форматирование - это то, где большинство преобразований Word-to-Markdown ошибаются. Толстый текст отображается как простой текст. Столы обрушиваются. Заголовки превращаются в стилизованные абзацы. Это руководство объясняет, что именно происходит во время Word в Markdown преобразование и как контролировать выход.
Понимание процесса преобразования
Когда вы конвертируете документ Word в Markdown, происходит две вещи:
- __П_А__ → __П_Б__ mammoth.js анализирует Word XML и отображает каждый элемент в HTML
- __П_Б__ → __П_А__ Turndown преобразует синтаксис HTML в Markdown
Второй шаг без потерь, если HTML чистый. Первый шаг - там, где форматирование имеет значение сложности стилей Words, которые должны быть отображены в известные эквиваленты HTML.
Использование WordToMDs преобразователь чтобы увидеть, как именно конвертируется ваш документ в режиме реального времени.
Стили заголовка
Наиболее важное решение форматирования в Word - использование встроенных стилей заголовков.
| Word Стиль | Markdown Выпуск |
|---|---|
| Рубрика 1 | # Heading |
| Рубрика 2 | ## Heading |
| Рубрика 3 | ### Heading |
| Нормальный (черный текст) | **text** (НЕТ заголовка) |
Общая ошибка: Ручное форматирование текста как большого и толстого, вместо применения стиля заголовка. Это выглядит как заголовок в Word но конвертирует в жирный текст в Markdown, не ##.
Полная ссылка на заголовки см. Markdown Руководство по заголовкам.
Подчеркивание текста
| Word Форматирование | Markdown Выпуск |
|---|---|
| Смелость | **Bold** |
| Курсификация | *Italic* |
| Курсификация | ***Bold Italic*** |
~~Strikethrough~~ | |
| Подчеркнуть | (не Markdown эквивалент исключен) |
| Подчеркнуто | (нет стандарта Markdown исключен) |
Подчерк и подчерк не имеют Markdown эквивалент в стандартном синтаксисе. После преобразования используйте HTML <u> теги или пользовательские классы CSS, если их поддерживает ваша публикационная платформа.
Списки
Word's автоматическое форматирование списка преобразует чисто:
- Bullet item one
- Bullet item two
- Nested bullet (indent 2 spaces)
1. First item
2. Second item
1. Nested numbered itemЧто ломает списки: Ручной введение черты или числа, которые не являются фактическими Word элементами списка. Они визуально похожи на списки, но Word рассматривает их как простые текстовые абзацы. Исправление: выберите их в Word и примените стиль List Bullet или List Number.
Таблицы
Стандартные таблицы преобразуются в GitHub Ароматизированные Markdown синтаксис таблицы:
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |Что ломает столы:
- Объединенные ячейки ячейка, охватывающая несколько столбцов или строк, будет свернута
- Содержание нескольких строк ячейки разрывы строк внутри ячеек удаляются
- Внутренний стол расширен до простого текста.
Полное распределение см. Markdown Таблицы: полное руководство.
Код и предварительно форматированный текст
Текст, форматированный монопространственным шрифтом (Courier New, Consolas) в Word-картах к встроенному коду:
Use `console.log()` to debug.Для огражденных блоков кода с подчеркиванием синтаксиса, применяйте Words Code стиль абзаца, если ваш шаблон имеет такой стиль, или вручную после преобразования добавить тройную ограждение. См. также: Markdown Руководство по блокам кода для полного синтаксиса.
Гиперссылки
Word гиперссылки конвертируются идеально:
Visit [WordToMD](https://wordtomd.org) for instant conversion.Текст ссылки и URL-адрес сохраняются. Блокмарки (внутренние ссылки в том же документе) могут не конвертироваться, если целевая точка не существует в Markdown.
Изображения
Изображения, где Word-to-Markdown преобразование последовательно не хватает. mammoth.js может извлекать встроенные изображения в качестве URI данных base64, но по умолчанию следует отметить их присутствие в Записках конверсии. После преобразования:
- Экспорт изображений из Word: Файл → Сохранить как → Веб-страница (HTML)
- Ссылка на них в Markdown:
Особые символы и символы
Word часто вставляет специальные символы Unicode автоматически:
- Умные котировки (
"...") → сохранены в виде символов Unicode - Ем даш (
—) → консервированный - Неразрывные пространства → преобразованы в регулярные пространства
- Символ авторского права (
©) → консервированный
Если вам нужен только выход ASCII, выполните поиск и замена в текстовом редакторе после преобразования.
Настраиваемые Word стили
Если в вашем документе Word используются пользовательские стили абзацев (например, Callout или Warning), mammoth.js записывает их в качестве примечаний к конверсии. Вы увидите сообщения типа Непризнанный стиль абзаца: Callout. WordToMD отфильтровывает эти информационные сообщения по умолчанию.
Для обработки пользовательских стилей вам нужна локальная Pandoc настройка с пользовательским фильтром см. Pandoc Word до Markdown для такого подхода.
Форматирование списка проверки перед конвертацией
Примените этот контрольный список к документу Word перед преобразованием:
- Все заголовки используют встроенные Word стили заголовка 1/2/3 (не ручное форматирование)
- Списки создаются с помощью инструментов списка Words (не вводятся чертежи/числа)
- Таблицы - это простые сетки (без объединенных ячеек)
- Код использует монопространственный шрифт
- Гиперссылки - это настоящие гиперссылки (не просто синий подчеркнутый текст)
FAQ
Почему мои заголовки преобразуются в жирный текст? Вы применили форматирование на черный шрифт + размер шрифта вместо стиля заголовка. В Word нажмите на абзац и посмотрите на панель стилей там должно быть написано Заголовок 1 не Нормальный.
Мой пронумерованный список перезапустился на 1 в неправильном месте как я могу это исправить? Установление продолжения списка в Word: правый клик на список → Продолжение нумерации. Или редактировать Markdown непосредственно после преобразования.
Настройка таблицы выглядит неправильно в Markdown. - Что случилось? - Я не знаю.
Использование таблиц GFM |---| для отделителей выравнивания. WordToMD генерирует их автоматически. Если отображение выглядит не так, проверьте, чтобы в клетках не было символов "pipe" (|) в их содержании избежать их как \|.
Заключение
Очищаюсь Word до Markdown форматирование в основном о правильном использовании Word. Применять встроенные стили заголовков, использовать Words список и таблицы инструменты, и вы будете получать почти идеальный выход из WordToMD преобразователь. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.