md2linkedin

https://www.indrapatil.com/md2linkedin/
Admin
md2linkedin converts Markdown text to LinkedIn-compatible plain text by replacing formatting markers...
Tokens:16,366
Snippets:103
Trust Score:2.1
Update:1 week ago
Show doc for...
Tokens:
Raw
### Install md2linkedin with uv

Source: https://www.indrapatil.com/md2linkedin

Install the md2linkedin package using uv. The source suggests running the CLI without installing via `uvx md2linkedin post.md`.

```bash
uv add md2linkedin

```

--------------------------------

### Example output from md2linkedin convert

Source: https://www.indrapatil.com/md2linkedin

This is the output produced by the preceding `convert` example. It shows the Markdown headings transformed to Mathematical Sans-Serif capitals with decorative lines, bold text as sans-serif bold, italic as mathematical italic, and bold-italic as mathematical bold-italic, while keeping bullet points as `•`.

```text
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
𝗘𝗫𝗖𝗜𝗧𝗜𝗡𝗚 𝗡𝗘𝗪𝗦
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

I'm thrilled to share that 𝘄𝗲 𝗷𝘂𝘀𝘁 𝗹𝗮𝘂𝗻𝗰𝗵𝗲𝗱 a new product!

Key highlights:

• 𝗣𝗲𝗿𝗳𝗼𝗿𝗺𝗮𝗻𝗰𝗲: 3𝘹 𝘧𝘢𝘴𝘵𝘦𝘳 than the previous version
• 𝗥𝗲𝗹𝗶𝗮𝗯𝗶𝗹𝗶𝘁𝘆: 𝙯𝙚𝙧𝙤 𝙙𝙤𝙬𝙣𝙩𝙞𝙢𝙚 deployments
• 𝗗𝗲𝘃𝗲𝗹𝗼𝗽𝗲𝗿 𝗨𝗫: clean, intuitive API

Check it out and let me know what you think.

```

--------------------------------

### to_sans_bold examples

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Examples of the to_sans_bold function showing conversion of alphanumerics, handling of non-ASCII characters, and empty string input.

```python
>>> to_sans_bold("Hello, World! 123")
'𝗛𝗲𝗹𝗹𝗼, 𝗪𝗼𝗿𝗹𝗱! 𝟭𝟮𝟯'
```

```python
>>> to_sans_bold("café")
'𝗰𝗮𝗳é'
```

```python
>>> to_sans_bold("")
''
```

--------------------------------

### to_sans_bold_italic examples

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Examples of the to_sans_bold_italic function showing conversion of letters and empty string input.

```python
>>> to_sans_bold_italic("Hello, World!")
'𝙃𝙚𝙡𝙡𝙤, 𝙒𝙤𝙧𝙡𝙙!'
```

```python
>>> to_sans_bold_italic("")
''
```

--------------------------------

### to_sans_italic examples

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Examples of the to_sans_italic function showing conversion of letters, handling of digits and symbols, and empty string input.

```python
>>> to_sans_italic("Hello, World!")
'𝘏𝘦𝘭𝘭𝘰, 𝘞𝘰𝘳𝘭𝘥!'
```

```python
>>> to_sans_italic("price: $42")
'𝘱𝘳𝘪𝘤𝘦: $42'
```

```python
>>> to_sans_italic("")
''
```

--------------------------------

### Run md2linkedin with uvx

Source: https://www.indrapatil.com/md2linkedin/advanced

Run `md2linkedin` directly with `uvx` without permanent installation. `uvx` downloads and caches the package in an isolated environment, so subsequent runs are fast.

```bash
# Convert a Markdown file (output: post.linkedin.txt)
uvx md2linkedin post.md

# Pipe from stdin
echo "**bold** and *italic*" | uvx md2linkedin

# Preserve link syntax
uvx md2linkedin --preserve-links post.md

# Explicit output path
uvx md2linkedin post.md -o linkedin_post.txt

# Disable monospace code rendering
uvx md2linkedin --no-monospace-code post.md
```

--------------------------------

### apply_style examples

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Shows the output of apply_style for each accepted style value: "bold", "italic", and "bold_italic". The function raises ValueError for any other style.

```python
>>> apply_style("hello", "bold")
'𝗵𝗲𝗹𝗹𝗼'

```

```python
>>> apply_style("hello", "italic")
'𝘩𝘦𝘭𝘭𝘰'

```

```python
>>> apply_style("hello", "bold_italic")
'𝙝𝙚𝙡𝙡𝙤'

```

--------------------------------

### to_monospace examples

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Shows the output of to_monospace for a mixed string, a string with non-ASCII characters, and an empty string. Non-ASCII characters like é pass through unchanged.

```python
>>> to_monospace("Hello, World! 123")
'𝙷𝚎𝚕𝚕𝚘, 𝚆𝚘𝚛𝚕𝚍! 𝟷𝟸𝟹'

```

```python
>>> to_monospace("café")
'𝚌𝚊𝚏é'

```

```python
>>> to_monospace("")
''

```

--------------------------------

### to_sans_bold examples

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Shows the output of to_sans_bold for a mixed string, a string with non-ASCII characters, and an empty string. Non-ASCII characters like é pass through unchanged.

```python
>>> to_sans_bold("Hello, World! 123")
'𝗛𝗲𝗹𝗹𝗼, 𝗪𝗼𝗿𝗹𝗱! 𝟭𝟮𝟯'

```

```python
>>> to_sans_bold("café")
'𝗰𝗮𝗳é'

```

```python
>>> to_sans_bold("")
''

```

--------------------------------

### Use md2linkedin CLI with various options

Source: https://www.indrapatil.com/md2linkedin

Command-line usage examples for the md2linkedin CLI. Converting a Markdown file writes to `post.linkedin.txt` by default; use `-o` to specify a different output path. The tool also accepts input via stdin pipe activity, and provides `--preserve-links` to keep link URLs and `--no-monospace-code` to disable monospace code rendering.

```bash
# Convert a Markdown file (output: post.linkedin.txt)
md2linkedin post.md

# Specify output path
md2linkedin post.md -o linkedin_post.txt

# Pipe from stdin
echo "**Hello**, *world*!" | md2linkedin

# Keep link URLs in the output
md2linkedin post.md --preserve-links

# Disable monospace code rendering
md2linkedin post.md --no-monospace-code

```

--------------------------------

### Apply Unicode styles with to_sans_bold, to_sans_italic, etc.

Source: https://www.indrapatil.com/md2linkedin/advanced

The Unicode mapping functions are public and can be used to apply a specific style to a plain string programmatically. The example shows to_sans_bold, to_sans_italic, to_sans_bold_italic, to_monospace, and apply_style for dynamic dispatch.

```python
from md2linkedin import (
    to_sans_bold,
    to_sans_italic,
    to_sans_bold_italic,
    to_monospace,
    apply_style,
)

to_sans_bold("Open to Work")  # 𝗢𝗽𝗲𝗻 𝘁𝗼 𝗪𝗼𝗿𝗸
to_sans_italic("3 years of exp")  # 3 𝘺𝘦𝘢𝘳𝘴 𝘰𝘧 𝘦𝘹𝘱
to_sans_bold_italic("Key insight")  # 𝙆𝙚𝙮 𝙞𝙣𝙨𝙞𝙜𝙝𝙩
to_monospace("print('hi')")  # 𝚙𝚛𝚒𝚗𝚝('𝚑𝚒')

# Dynamic dispatch
apply_style("Hiring!", "bold")

```

--------------------------------

### Convert Markdown string with convert()

Source: https://www.indrapatil.com/md2linkedin/advanced

Use convert() to transform a Markdown string into a plain-text string ready for LinkedIn. The example shows bold and italic Markdown being converted to Unicode bold and italic characters.

```python
from md2linkedin import convert

result = convert("**Hello**, *world*!")
print(result)  # 𝗛𝗲𝗹𝗹𝗼, 𝘸𝘰𝘳𝘭𝘥!

```

--------------------------------

### Convert nested bullet lists with convert()

Source: https://www.indrapatil.com/md2linkedin/advanced

Demonstrates nested bullet list conversion. Each nesting level gets its own marker (•, ‣, ◦, ▪) and two spaces of indentation; depth is counted from the parsed tree, not raw indentation.

```python
convert("- Role\n  - Applications\n    - AI Launchpad")
# • Role
#   ‣ Applications
#     ◦ AI Launchpad
```

--------------------------------

### Convert Markdown to LinkedIn text using md2linkedin.convert

Source: https://www.indrapatil.com/md2linkedin

Use the `convert` function from the `md2linkedin` package to transform Markdown text with bold, italic, and bold-italic markers into Unicode Mathematical Sans-Serif characters. The output preserves visual formatting as shown in the following example. The `# @pyodide` comment indicates it can run in a Pyodide environment.

```python
# @pyodide
from md2linkedin import convert

md = """
# Exciting News

I'm thrilled to share that **we just launched** a new product!

Key highlights:

- **Performance**: *3x faster* than the previous version
- **Reliability**: ***zero downtime*** deployments
- **Developer UX**: clean, intuitive API

Check it out and let me know what you think.
"""

print(convert(md))

```

--------------------------------

### convert_file()

Source: https://www.indrapatil.com/md2linkedin/advanced

Reads a Markdown file and writes the output to a text file, returning the path of the written file.

```APIDOC
## convert_file()

### Description
Reads a Markdown file and writes the output to a text file, returning the path of the written file.

### Method
Function

### Signature
`convert_file(input_path: str, output_path: str = None, preserve_links: bool = False) -> Path`

### Parameters
- **input_path** (str) - Required - Path to the input Markdown file.
- **output_path** (str) - Optional - Path to the output text file. If not provided, defaults to the input filename with `.linkedin.txt` appended.
- **preserve_links** (bool) - Optional - If True, retains Markdown link syntax in the output. Defaults to False.

### Returns
- **Path** - The path of the written file.

### Example
```python
from md2linkedin import convert_file

out = convert_file("post.md")
print(f"Written to: {out}")  # post.linkedin.txt

# Override the output path
out = convert_file("post.md", "my_post.txt")
```
```

--------------------------------

### convert()

Source: https://www.indrapatil.com/md2linkedin/advanced

Converts a Markdown string to a plain-text string ready for LinkedIn.

```APIDOC
## convert()

### Description
Converts a Markdown string to a plain-text string ready for LinkedIn.

### Method
Function

### Signature
`convert(markdown_string: str) -> str`

### Parameters
- **markdown_string** (str) - Required - The Markdown string to convert.

### Returns
- **str** - The converted plain-text string.

### Example
```python
from md2linkedin import convert

result = convert("**Hello**, *world*!")
print(result)  # 𝗛𝗲𝗹𝗹𝗼, 𝘸𝘰𝘳𝘭𝘥!
```
```

--------------------------------

### Convert large Markdown file

Source: https://www.indrapatil.com/md2linkedin/advanced

`convert()` does no I/O and holds only the document, its HTML, and the output. Parsing happens in Rust and C, scaling linearly with input length, so it is safe for large files.

```python
big_md = Path("quarterly_report.md").read_text()
result = convert(big_md)
```

--------------------------------

### Pandoc LaTeX to LinkedIn via pipe

Source: https://www.indrapatil.com/md2linkedin/advanced

Pipe LaTeX through `pandoc` to convert to Markdown, then feed to `md2linkedin` for LinkedIn-friendly text.

```bash
pandoc --from=latex --to=markdown_strict --wrap=none resume.tex | md2linkedin
```

--------------------------------

### apply_style(text, style)

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Applies a Unicode sans-serif style to text. Routes to the appropriate mapping function based on the requested style.

```APIDOC
## apply_style(text, style)

### Description
Applies a Unicode sans-serif style to text. A convenience dispatcher that routes to the appropriate mapping function based on the requested style. Useful when the style is determined dynamically at runtime.

### Method
Function call

### Parameters
- **text** (str) - Required - The input string to convert.
- **style** (Literal['bold', 'italic', 'bold_italic']) - Required - One of "bold", "italic", or "bold_italic".

### Returns
- **str** - A new string with the requested Unicode style applied.

### Raises
- **ValueError** - If style is not one of the three accepted values.

### Examples
```
>>> apply_style("hello", "bold")
'𝗵𝗲𝗹𝗹𝗼'
```

```
>>> apply_style("hello", "italic")
'𝘩𝘦𝘭𝘭𝘰'
```

```
>>> apply_style("hello", "bold_italic")
'𝙝𝙚𝙡𝙡𝙤'
```
```

--------------------------------

### Convert Markdown file with convert_file()

Source: https://www.indrapatil.com/md2linkedin/advanced

Use convert_file() to read a .md file and write the output to a .txt file. The function returns the Path of the written file, allowing chaining. The default output filename is the input basename with .linkedin.txt appended, but you can override it with a second argument.

```python
from md2linkedin import convert_file

out = convert_file("post.md")
print(f"Written to: {out}")  # post.linkedin.txt

# Override the output path
out = convert_file("post.md", "my_post.txt")

```

--------------------------------

### Preserve links with preserve_links=True

Source: https://www.indrapatil.com/md2linkedin/advanced

By default, Markdown link syntax is stripped to display text only. Pass preserve_links=True to retain the full link syntax in the output, as shown for both convert() and convert_file().

```python
result = convert("[GitHub](https://github.com)", preserve_links=True)
# [GitHub](https://github.com)

result = convert_file("post.md", preserve_links=True)

```

--------------------------------

### Pandoc LaTeX to LinkedIn in Python

Source: https://www.indrapatil.com/md2linkedin/advanced

Python equivalent of piping LaTeX through `pandoc` and then converting with `md2linkedin`. Uses `subprocess.run` with `check=True` to raise on errors.

```python
import subprocess
from md2linkedin import convert

result = subprocess.run(
    ["pandoc", "--from=latex", "--to=markdown_strict", "--wrap=none"],
    input=Path("resume.tex").read_text(),
    capture_output=True,
    text=True,
    check=True,
)
linkedin_text = convert(result.stdout)
```

--------------------------------

### to_sans_bold(text: str) -> str

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts ASCII alphanumerics to bold sans-serif Unicode equivalents. Digits are also mapped, while other characters pass through unchanged.

```APIDOC
## to_sans_bold(text: str) -> str

### Description
Converts ASCII alphanumerics to bold sans-serif Unicode equivalents. Digits are also mapped, while other characters pass through unchanged.

### Parameters
- **text** (str) - Required - The input string to convert.

### Returns
- **str** - A new string with ASCII alphanumerics replaced by bold sans-serif Unicode equivalents.

### Examples
python
>>> to_sans_bold("Hello, World! 123")
'𝗛𝗲𝗹𝗹𝗼, 𝗪𝗼𝗿𝗹𝗱! 𝟭𝟮𝟯'

>>> to_sans_bold("café")
'𝗰𝗮𝗳é'

>>> to_sans_bold("")
''

```

--------------------------------

### apply_style source code

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Implementation of apply_style from src/md2linkedin/_unicode.py. Dispatches to to_sans_bold, to_sans_italic, or to_sans_bold_italic based on the style argument, and raises ValueError for unknown styles.

```python
def apply_style(text: str, style: Literal["bold", "italic", "bold_italic"]) -> str:
    """Apply a Unicode sans-serif style to text.

    A convenience dispatcher that routes to the appropriate mapping function
    based on the requested style. Useful when the style is determined
    dynamically at runtime.

    Args:
        text: The input string to convert.
        style: One of ``"bold"``, ``"italic"``, or ``"bold_italic"``.

    Returns:
        A new string with the requested Unicode style applied.

    Raises:
        ValueError: If *style* is not one of the three accepted values.

    Examples:
        >>> apply_style("hello", "bold")
        '𝗵𝗲𝗹𝗹𝗼'

        >>> apply_style("hello", "italic")
        '𝘩𝘦𝘭𝘭𝘰'

        >>> apply_style("hello", "bold_italic")
        '𝙝𝙚𝙡𝙡𝙤'

    """
    if style == "bold":
        return to_sans_bold(text)
    if style == "italic":
        return to_sans_italic(text)
    if style == "bold_italic":
        return to_sans_bold_italic(text)
    msg = f"Unknown style {style!r}. Expected 'bold', 'italic', or 'bold_italic'."
    raise ValueError(msg)

```

--------------------------------

### to_sans_bold_italic(text: str) -> str

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts ASCII letters to bold-italic sans-serif Unicode equivalents. Digits and other characters pass through unchanged.

```APIDOC
## to_sans_bold_italic(text: str) -> str

### Description
Converts ASCII letters to bold-italic sans-serif Unicode equivalents. Digits and other characters pass through unchanged.

### Parameters
- **text** (str) - Required - The input string to convert.

### Returns
- **str** - A new string with ASCII letters replaced by bold-italic sans-serif Unicode equivalents.

### Examples
python
>>> to_sans_bold_italic("Hello, World!")
'𝙃𝙚𝙡𝙡𝙤, 𝙒𝙤𝙧𝙡𝙙!'

>>> to_sans_bold_italic("")
''

```

--------------------------------

### md2linkedin CLI reference

Source: https://www.indrapatil.com/md2linkedin/advanced

CLI reference for `md2linkedin`, showing usage and options: `-o/--output`, `--preserve-links`, `--no-monospace-code`, `-V/--version`, and `-h/--help`.

```text
Usage: md2linkedin [OPTIONS] [INPUT_FILE]

  Convert Markdown to LinkedIn-friendly Unicode text.

Options:
  -o, --output PATH    Output file path.
  --preserve-links     Keep link syntax in output.
  --no-monospace-code  Disable monospace Unicode rendering for code.
  -V, --version        Show the version and exit.
  -h, --help           Show this message and exit.
```

--------------------------------

### to_sans_bold(text)

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts text to Unicode Mathematical Sans-Serif Bold. Maps ASCII alphanumerics to bold sans-serif equivalents, leaving other characters unchanged.

```APIDOC
## to_sans_bold(text)

### Description
Converts text to Unicode Mathematical Sans-Serif Bold. ASCII uppercase letters, lowercase letters, and digits are mapped to their bold sans-serif counterparts. All other characters (spaces, punctuation, non-ASCII) pass through unchanged.

### Method
Function call

### Parameters
- **text** (str) - Required - The input string to convert.

### Returns
- **str** - A new string with ASCII alphanumerics replaced by bold sans-serif Unicode equivalents.

### Examples
```
>>> to_sans_bold("Hello, World! 123")
'𝗛𝗲𝗹𝗹𝗼, 𝗪𝗼𝗿𝗹𝗱! 𝟭𝟮𝟯'
```

```
>>> to_sans_bold("café")
'𝗰𝗮𝗳é'
```

```
>>> to_sans_bold("")
''
```
```

--------------------------------

### Convert inline code to monospace

Source: https://www.indrapatil.com/md2linkedin/advanced

Demonstrates that inline code is converted to Unicode Mathematical Monospace characters. Only ASCII letters and digits are mapped; all other characters (including Markdown syntax like **) pass through unchanged, and no nested processing is performed.

```python
convert("Use `**bold**` in Markdown")
# → Use **𝚋𝚘𝚕𝚍** in Markdown   (backticks stripped, letters monospaced, ** kept)
```

--------------------------------

### to_monospace(text)

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts text to Unicode Mathematical Monospace. Maps ASCII alphanumerics to monospace equivalents, leaving other characters unchanged.

```APIDOC
## to_monospace(text)

### Description
Converts text to Unicode Mathematical Monospace. ASCII uppercase letters, lowercase letters, and digits are mapped to their monospace counterparts. All other characters (spaces, punctuation, non-ASCII) pass through unchanged.

### Method
Function call

### Parameters
- **text** (str) - Required - The input string to convert.

### Returns
- **str** - A new string with ASCII alphanumerics replaced by monospace Unicode equivalents.

### Examples
```
>>> to_monospace("Hello, World! 123")
'𝙷𝚎𝚕𝚕𝚘, 𝚆𝚘𝚛𝚕𝚍! 𝟷𝟸𝟹'
```

```
>>> to_monospace("café")
'𝚌𝚊𝚏é'
```

```
>>> to_monospace("")
''
```
```

--------------------------------

### to_sans_italic(text: str) -> str

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts ASCII letters to italic sans-serif Unicode equivalents. Digits and other characters pass through unchanged.

```APIDOC
## to_sans_italic(text: str) -> str

### Description
Converts ASCII letters to italic sans-serif Unicode equivalents. Digits and other characters pass through unchanged.

### Parameters
- **text** (str) - Required - The input string to convert.

### Returns
- **str** - A new string with ASCII letters replaced by italic sans-serif Unicode equivalents.

### Examples
python
>>> to_sans_italic("Hello, World!")
'𝘏𝘦𝘭𝘭𝘰, 𝘞𝘰𝘳𝘭𝘥!'

>>> to_sans_italic("price: $42")
'𝘱𝘳𝘪𝘤𝘦: $42'

>>> to_sans_italic("")
''

```

--------------------------------

### Unicode Mapping Functions

Source: https://www.indrapatil.com/md2linkedin/advanced

Public functions for applying specific Unicode styles to plain strings.

```APIDOC
## Unicode Mapping Functions

### Description
Public functions for applying specific Unicode styles to plain strings.

### Functions

#### to_sans_bold(text: str) -> str
- **text** (str) - Required - The string to style.
- **Returns** (str) - The string with sans-serif bold Unicode characters.

#### to_sans_italic(text: str) -> str
- **text** (str) - Required - The string to style.
- **Returns** (str) - The string with sans-serif italic Unicode characters.

#### to_sans_bold_italic(text: str) -> str
- **text** (str) - Required - The string to style.
- **Returns** (str) - The string with sans-serif bold-italic Unicode characters.

#### to_monospace(text: str) -> str
- **text** (str) - Required - The string to style.
- **Returns** (str) - The string with monospace Unicode characters.

#### apply_style(text: str, style: str) -> str
- **text** (str) - Required - The string to style.
- **style** (str) - Required - The style name (e.g., "bold").
- **Returns** (str) - The styled string.

### Example
```python
from md2linkedin import (
    to_sans_bold,
    to_sans_italic,
    to_sans_bold_italic,
    to_monospace,
    apply_style,
)

to_sans_bold("Open to Work")  # 𝗢𝗽𝗲𝗻 𝘁𝗼 𝗪𝗼𝗿𝗸
to_sans_italic("3 years of exp")  # 3 𝘺𝘦𝘢𝘳𝘴 𝘰𝘧 𝘦𝘹𝘱
to_sans_bold_italic("Key insight")  # 𝙆𝙚𝙮 𝙞𝙣𝙨𝙞𝙜𝙝𝙩
to_monospace("print('hi')")  # 𝚙𝚛𝚒𝚗𝚝('𝚑𝚒')

# Dynamic dispatch
apply_style("Hiring!", "bold")
```
```

--------------------------------

### Convert list item with fenced code block

Source: https://www.indrapatil.com/md2linkedin/advanced

Shows how a fenced code block inside a list item is converted: the code is rendered in monospace Unicode, and the item's content is indented to the column the marker opened. A loose list keeps the blank line between items.

```python
convert("- item\n\n  ```\n  a = 1\n  ```")
# • item
#
#   𝚊 = 𝟷
```

--------------------------------

### to_sans_bold_italic function definition

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts ASCII letters to bold-italic sans-serif Unicode equivalents. Digits and other characters pass through unchanged.

```python
def to_sans_bold_italic(text: str) -> str:
    """Convert text to Unicode Mathematical Sans-Serif Bold Italic.

    ASCII uppercase and lowercase letters are mapped to their bold-italic
    sans-serif counterparts. Digits and all other characters pass through
    unchanged.

    Args:
        text: The input string to convert.

    Returns:
        A new string with ASCII letters replaced by bold-italic sans-serif
        Unicode equivalents.

    Examples:
        >>> to_sans_bold_italic("Hello, World!")
        '𝙃𝙚𝙡𝙡𝙤, 𝙒𝙤𝙧𝙡𝙙!'

        >>> to_sans_bold_italic("")
        ''

    """
    return text.translate(_SANS_BOLD_ITALIC_TABLE)
```

--------------------------------

### Unmatched markers are left untouched

Source: https://www.indrapatil.com/md2linkedin/advanced

Unmatched asterisks or underscores are left untouched; `md2linkedin` never crashes on malformed input.

```python
convert("price: $10 * 3")  # → price: $10 * 3 (no crash)
convert("under_score alone")  # → unchanged
```

--------------------------------

### to_sans_bold function definition

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts ASCII alphanumerics to bold sans-serif Unicode equivalents. Digits are mapped to bold digits, while other characters pass through unchanged. The function uses a translation table and returns a new string.

```python
def to_sans_bold(text: str) -> str:
    """Convert text to Unicode Mathematical Sans-Serif Bold.

    ASCII uppercase and lowercase letters are mapped to their bold
    sans-serif counterparts. Digits are also mapped to bold digits.
    All other characters pass through unchanged.

    Args:
        text: The input string to convert.

    Returns:
        A new string with ASCII alphanumerics replaced by bold sans-serif
        Unicode equivalents.

    Examples:
        >>> to_sans_bold("Hello, World! 123")
        '𝗛𝗲𝗹𝗹𝗼, 𝗪𝗼𝗿𝗹𝗱! 𝟭𝟮𝟯'

        >>> to_sans_bold("café")
        '𝗰𝗮𝗳é'

        >>> to_sans_bold("")
        ''

    """
    return text.translate(_SANS_BOLD_TABLE)
```

--------------------------------

### to_sans_bold source code

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Implementation of to_sans_bold from src/md2linkedin/_unicode.py. Uses str.translate with the internal _SANS_BOLD_TABLE to map ASCII alphanumerics to bold sans-serif Unicode equivalents.

```python
def to_sans_bold(text: str) -> str:
    """Convert text to Unicode Mathematical Sans-Serif Bold.

    ASCII uppercase letters, lowercase letters, and digits are mapped to
    their bold sans-serif counterparts. All other characters (spaces,
    punctuation, non-ASCII) pass through unchanged.

    Args:
        text: The input string to convert.

    Returns:
        A new string with ASCII alphanumerics replaced by bold sans-serif
        Unicode equivalents.

    Examples:
        >>> to_sans_bold("Hello, World! 123")
        '𝗛𝗲𝗹𝗹𝗼, 𝗪𝗼𝗿𝗹𝗱! 𝟭𝟮𝟯'

        >>> to_sans_bold("café")
        '𝗰𝗮𝗳é'

        >>> to_sans_bold("")
        ''

    """
    return text.translate(_SANS_BOLD_TABLE)

```

--------------------------------

### convert function: Convert Markdown string to LinkedIn-compatible text

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Converts a Markdown string to LinkedIn-compatible Unicode plain text. Returns an empty string for empty or whitespace-only input. Uses comrak for rendering with unsafe_ enabled for raw HTML pass-through, and strikethrough, table, and autolink extensions. Trailing whitespace is stripped and a newline is appended.

```python
def convert(
    text: str,
    *,
    preserve_links: bool = False,
    monospace_code: bool = True,
) -> str:
    r"""Convert Markdown text to LinkedIn-compatible Unicode plain text.

    Args:
        text: The Markdown source string.
        preserve_links: When ``True``, link syntax (``[text](url)``) is left
            unchanged in the output instead of being reduced to display text.
        monospace_code: When ``True`` (the default), inline code spans and
            fenced code blocks are rendered in Unicode Mathematical Monospace.
            When ``False``, code is kept as plain text, with the backticks
            and fences stripped.

    Returns:
        A plain-text string suitable for pasting into LinkedIn.

    """
    if not text or not text.strip():
        return ""

    render_options = comrak.RenderOptions()
    render_options.compact_html = True
    # Raw HTML is passed through to the parser below, which reads the text out
    # of it. Nothing is ever rendered as HTML, so nothing can be injected.
    render_options.unsafe_ = True

    extensions = comrak.ExtensionOptions()
    extensions.strikethrough = True
    extensions.table = True
    extensions.autolink = True

    html = comrak.render_markdown(
        text,
        extension_options=extensions,
        render_options=render_options,
    )

    tree = HTMLParser(html)
    renderer = Renderer(
        preserve_links=preserve_links,
        monospace_code=monospace_code,
    )
    out = renderer.render(tree.root)
    # An item that holds nothing but a nested list leaves its marker alone on
    # a line; no line is meant to end in blank space.
    return _TRAILING_SPACE.sub("", out).strip() + "\n"
```

--------------------------------

### Disable monospace code rendering with monospace_code=False

Source: https://www.indrapatil.com/md2linkedin/advanced

Disables monospace code rendering with `monospace_code=False`. Backticks and fences are stripped, but the content remains plain text, so Markdown inside code is not interpreted.

```python
convert("Use `**bold**` in Markdown", monospace_code=False)
# → Use **bold** in Markdown   (backticks stripped, content as plain text)
```

```python
convert("```\n**not bold**\n```", monospace_code=False)
# → **not bold**               (fences stripped, content as plain text)
```

--------------------------------

### Convert nested emphasis with convert()

Source: https://www.indrapatil.com/md2linkedin/advanced

Shows how nested emphasis is converted: an inner span is styled inside the outer one rather than replacing it. The first call produces bold-italic Unicode, the second produces bold wrapping italic.

```python
convert("***very important***")  # → bold-italic Unicode
convert("**bold and *italic* inside**")  # → bold wrapping italic
```

--------------------------------

### to_monospace source code

Source: https://www.indrapatil.com/md2linkedin/reference/converter

Implementation of to_monospace from src/md2linkedin/_unicode.py. Uses str.translate with the internal _MONOSPACE_TABLE to map ASCII alphanumerics to monospace Unicode equivalents.

```python
def to_monospace(text: str) -> str:
    """Convert text to Unicode Mathematical Monospace.

    ASCII uppercase letters, lowercase letters, and digits are mapped to
    their monospace counterparts. All other characters (spaces,
    punctuation, non-ASCII) pass through unchanged.

    Args:
        text: The input string to convert.

    Returns:
        A new string with ASCII alphanumerics replaced by monospace
        Unicode equivalents.

    Examples:
        >>> to_monospace("Hello, World! 123")
        '𝙷𝚎𝚕𝚕𝚘, 𝚆𝚘𝚛𝚕𝚍! 𝟷𝟸𝟹'

        >>> to_monospace("café")
        '𝚌𝚊𝚏é'

        >>> to_monospace("")
        ''

    """
    return text.translate(_MONOSPACE_TABLE)

```

--------------------------------

### Convert fenced code block to monospaced Unicode

Source: https://www.indrapatil.com/md2linkedin/advanced

Converts a fenced code block to monospaced Unicode text, stripping the fences. The content is not parsed as Markdown.

```python
convert("```\nprint('hi')\n```")
# → 𝚙𝚛𝚒𝚗𝚝('𝚑𝚒')   (fences stripped, content monospaced)
```
Tokens:
Raw