Saltar al contenido principal

Importar desde Markdown (Obsidian) y Word

Muchos autores empiezan el manuscrito en otra herramienta: una bóveda de Obsidian, un conjunto de archivos Markdown o un documento de Microsoft Word. Este tutorial explica las dos rutas más habituales hacia un Project de Scribe ordenado:

  • Parte A: Markdown u Obsidian → Scribe.
  • Parte B: Word (.docx) → Scribe.

En ambos casos, el resultado es un Project en el que los capítulos se gestionan como documentos Markdown, las imágenes permanecen en los recursos y el orden y la inclusión del árbol están preparados para la vista previa y la exportación.

Reserve unos 30 minutos por parte para un manuscrito de extensión novelística.

Antes de empezar​

Necesita:

  • un manuscrito terminado o en curso en Markdown, Obsidian o Word;
  • Scribe instalado y con la sesión iniciada; Free es suficiente para importar;
  • una copia de seguridad de la carpeta de origen o del archivo .docx.

Cree la copia antes de comenzar. La importación no la sustituye. Compruebe el contenido importado antes de decidir dónde mantendrá el manuscrito a partir de entonces.

Parte A: de Markdown u Obsidian a Scribe​

A1. Crear un Project vacío​

  1. Abra Scribe y seleccione Nuevo proyecto en la pantalla de bienvenida.
  2. En el selector del sistema, cree o elija una carpeta vacía con el nombre del manuscrito.
  3. Scribe abre la carpeta como Project vacío.

Mantenga el manuscrito de origen fuera de esta carpeta hasta que esté listo para importarlo.

A2. Importar carpetas y archivos​

Una bóveda de Obsidian o carpeta Markdown suele tener una estructura parecida a esta:

mi-novela/
├── 01-inicio.md
├── 02-encuentro.md
├── 03-ascenso.md
└── images/
    ├── mapa.png
    └── separador-capitulo-3.png

En el Project nuevo, seleccione Importar > Importar carpeta en la barra de acciones del árbol. Scribe puede incorporar juntos archivos .md, .markdown, .txt y .docx y conservar la jerarquía original cuando sea posible.

Si prefiere organizarlos de forma manual, coloque los capítulos Markdown en la carpeta del manuscrito y reúna las imágenes dentro de assets/. Scribe detecta los archivos nuevos y actualiza el árbol.

A3. Comprobar nombres, estructura y front matter​

La importación usa el nombre de cada archivo como base para el nombre visible en Scribe. Revise los nombres, la jerarquía y la estructura del cuerpo antes de continuar.

El front matter YAML de Obsidian no se copia en Ajustes del proyecto. Revise campos como tags, cssclass y publish y consérvelos, reescríbalos o elimínelos según el manuscrito. Introduzca por separado la información editorial en Ajustes del proyecto.

A4. Reescribir la sintaxis propia de Obsidian​

Obsidian añade extensiones de Markdown que Scribe no interpreta de forma nativa. Decida cómo desea sustituirlas:

Sintaxis de ObsidianSustitución recomendada en Scribe
[[Enlace interno]]Enlace normal [Enlace interno](./otro-capitulo.md) o título en cursiva si no es una referencia real.
[[Imagen.png]] incrustadaImagen Markdown normal ![](assets/Imagen.png).
![[Nota#Encabezado]] transcluidoCopie manualmente el contenido necesario. Scribe no inserta el contenido de notas enlazadas.
==resaltado==Use *énfasis* o elimínelo.
%%comentario%%Comentario HTML <!-- comentario -->.
Avisos (> [!note])Conviértalos en una cita normal o elimine la línea de marcador y conserve el cuerpo.

Un proceso sencillo en dos pasos:

  1. Abra la carpeta en un editor que permita buscar y reemplazar en varios archivos, como VS Code, Sublime Text, BBEdit o Neovim.
  2. Aplique las sustituciones anteriores en orden, desde las menos invasivas.

No necesita corregir todos los enlaces antes de abrir el Project. Los enlaces no compatibles se muestran como texto normal y puede ajustarlos durante la revisión.

A5. Comprobar el orden de los capítulos​

Cuando los capítulos aparezcan en el árbol, arrástrelos al orden de lectura previsto y abra varios para confirmar su contenido.

A6. Completar los metadatos​

Abra Ajustes del proyecto desde la barra lateral y complete título, subtítulo, autor, idioma, descripción y, si la necesita, una portada EPUB. Esta información se usa en la exportación y en los shortcodes.

Parte B: de Word (.docx) a Scribe​

Scribe puede importar archivos .docx directamente. Limpie primero los estilos de Word y use Archivo > Importar documento… para un archivo o Importar > Importar carpeta para una carpeta. La importación conserva la estructura textual habitual, pero no reproduce toda la maquetación de Word.

B1. Limpiar primero el documento de Word​

Una preparación breve mejora el Markdown importado:

  • acepte todos los cambios controlados;
  • elimine los comentarios;
  • normalice los estilos: títulos de capítulo con Encabezado 1, separadores de escena con Encabezado 2 o tres asteriscos centrados y cuerpo con el estilo normal;
  • elimine los saltos de página dentro de los capítulos; Scribe pagina según la estructura;
  • conserve el texto de los pies de imagen que necesite. Deberá volver a añadir las imágenes en Scribe, que no ofrece un campo independiente para pies.

B2. Importar el .docx​

Para un documento de Word, use Archivo > Importar documento…. Si el libro ya está dividido en varios archivos .docx, use Importar > Importar carpeta.

Compruebe primero en la vista previa:

  • que encabezados, párrafos, negrita, cursiva, enlaces, listas, citas y código mantengan el orden esperado;
  • que los separadores de escena permanezcan en su lugar;
  • que tablas, imágenes, notas al pie y notas finales se hayan vuelto a crear o reescrito cuando sea necesario.

B3. Dividir por encabezados cuando sea necesario​

Antes de importar un documento largo, active Dividir por encabezados # si cada encabezado de nivel uno debe iniciar un documento de Scribe. En manuscritos largos, los documentos separados facilitan el orden, la compilación y el alcance de exportación.

B4. Limpiar los restos de la importación​

Revise:

  • Párrafos con saltos innecesarios: elimine los saltos de línea suaves dentro de los párrafos.
  • Comillas tipográficas: la importación suele conservarlas; no las sustituya por comillas rectas sin necesidad.
  • Marcadores: elimine los que no use y conserve los que formen referencias cruzadas.
  • Estilos en línea: sustituya estilos de carácter que no tengan equivalente por *cursiva* o **negrita**.
  • Tablas: reescríbalas como párrafos, listas o imágenes cuando sea necesario.
  • Imágenes: vuelva a añadirlas mediante Insertar imagen > Importar desde disco….

B5. Conversión previa con pandoc​

Si su equipo usa herramientas de línea de comandos o necesita convertir archivos por lotes, puede usar pandoc para convertir .docx a Markdown compatible con GitHub y seguir después el proceso de la Parte A. Esta ruta permite revisar los archivos convertidos fuera de Scribe antes de importarlos.

Lo que ha aprendido​

  • Cómo trasladar una bóveda de Obsidian a la estructura de un Project de Scribe.
  • Cómo sustituir sintaxis de Obsidian que Scribe no interpreta.
  • Cómo importar Word, comprobar la estructura conservada y volver a crear elementos no compatibles.
  • Cómo organizar metadatos, imágenes y orden de compilación para el resto del flujo.

Siguientes pasos​